405
Chương 10: Cơ sở dữ liệu
Bảng 10.5 Các thành viên thông dụng của các lớp data-reader
Thành viên
Mô tả
Thuộc tính
FieldCount
Lấy số cột trong hàng hiện tại.
IsClosed
Trả về
true
nếu
IDataReader
bị đóng;
false
nếu nó hiện đang mở.
Item
Trả về một đối tượng mô tả giá trị của cột cụ thể trong hàng hiện tại.
Cột có thể được chỉ định bằng một chỉ số nguyên (đánh số từ 0) hoặc
một chuỗi chứa tên cột. Bạn phải ép giá trị trả về thành kiểu phù hợp.
Đây là bộ chỉ mục (indexer) cho các lớp data-reader.
Phương thức
GetDataTypeName
Lấy tên của kiểu dữ liệu đối với một cột cụ thể.
GetFieldType
Lấy đối tượng
System.Type
mô tả kiểu dữ liệu của giá trị chứa trong
cột cụ thể (cột này được chỉ định bằng một chỉ số nguyên—đánh số
từ 0).
GetName
Lấy tên của cột cụ thể (cột này được chỉ định bằng một chỉ số
nguyên—đánh số từ 0).
GetOrdinal
Lấy số thứ tự cột (đánh số từ 0) ứng với một tên cột cụ thể.
GetSchemaTable
Trả về đối tượng
System.Data.DataTable
chứa siêu dữ liệu mô tả các
cột có trong
IDataReader
.
IsDBNull
Trả về
true
nếu giá trị trong cột cụ thể chứa giá trị
null
; nếu không
thì trả về
false
.
NextResult
Nếu
IDataReader
chứa nhiều tập kết quả vì có nhiều lệnh được thực
thi,
NextResult
sẽ di chuyển đến các tập kết quả kế tiếp. Theo mặc
định,
IDataReader
được bố trí tại tập kết quả đầu tiên.
Read
Dịch reader đến bản ghi kế tiếp. Reader luôn bắt đầu tại bản ghi đầu
tiên.
Data-reader Server và Oracle cũng chứa các phương thức thực hiện việc lấy dữ liệu thuộc các
kiểu dữ liệu đặc trưng của data-source. Ví dụ,
SqlDataReader
chứa các phương thức như
GetSqlByte
,
GetSqlDecimal
, và
GetSqlMoney
, và
OracleDataReader
chứa các phương thức như
GetOracleLob
,
GetOracleNumber
, và
GetOracleMonthSpan
. Bạn hãy tham khảo tài liệu .NET
Framework SDK để biết thêm chi tiết.
Khi đã hoàn tất với data-reader, bạn nên gọi phương thức
Close
để có thể sử dụng lại kết nối
cơ sở dữ liệu.
IDataReader
thừa kế
System.IDisposable
; nghĩa là mỗi lớp data-reader đều
hiện thực phương thức
Dispose
. Phương thức này
sẽ tự động gọi
Close
, cho nên lệnh
using
là
một cách rất rõ ràng và hiệu quả khi sử dụng data-reader.
