DataTableReader 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
DataTableReader 取得一或多個 DataTable 物件的內容,並以一或多個唯讀、正向的結果集形式呈現。
public ref class DataTableReader sealed : System::Data::Common::DbDataReader
public sealed class DataTableReader : System.Data.Common.DbDataReader
type DataTableReader = class
inherit DbDataReader
Public NotInheritable Class DataTableReader
Inherits DbDataReader
- 繼承
備註
其 DataTableReader 運作方式與其他資料讀取器類似,例如, SqlDataReader但 允許 DataTableReader 在 中遍 DataTable歷列。 換句話說,它允許在快取中反覆迭代資料列。 快取資料可在 啟動 DataTableReader 時修改,讀取器會自動維持其位置。
當你從 建立 DataTable時DataTableReader,結果DataTableReader物件包含一個與原始資料相同的DataTable結果集,除了標記為刪除的列外。 欄位的出現順序與原始 DataTable相同。 回傳結果的結構在結構與資料上與原始 DataTable完全相同。 由呼叫CreateDataReader物件方法DataSet所建立的 A DataTableReader 包含多個結果集,且該DataSet物件包含多個資料表。 結果的順序與DataTable該物件中的DataTableCollectionDataSet物件相同。
回傳的結果集僅包含每個 DataRow版本的當前版本;標記為刪除的列會被跳過。
提供 DataTableReader 一個穩定的迭代器;也就是說,若在迭代過程中修改底層集合大小,該內容 DataTableReader 不會失效。 例如,若在迭代過程中刪除或移除集合中的 Rows 一列或多列,當前位置 DataTableReader 會被適當維持,且不會使迭代器失效。
建構函式
| 名稱 | Description |
|---|---|
| DataTableReader(DataTable) |
利用所提供DataTable的資料初始化類別的新DataTableReader實例。 |
| DataTableReader(DataTable[]) |
使用提供的物件陣列DataTable初始化該DataTableReader類別的新實例。 |
屬性
| 名稱 | Description |
|---|---|
| Depth |
當前列 DataTableReader的巢狀深度。 |
| FieldCount |
回傳當前列的欄位數。 |
| HasRows |
會得到一個值,表示是否 DataTableReader 包含一列或多列。 |
| IsClosed |
會得到一個表示是否 DataTableReader 封閉的值。 |
| Item[Int32] |
取得指定資料行的原生格式,指定資料行序數的值。 |
| Item[String] |
取得指定數據行名稱的原生格式指定數據行的值。 |
| RecordsAffected |
取得執行 SQL 陳述式時插入、變更或刪除的列數。 |
| VisibleFieldCount |
取得中未被隱藏的欄位 DbDataReader 數量。 (繼承來源 DbDataReader) |
方法
明確介面實作
| 名稱 | Description |
|---|---|
| IDataRecord.GetData(Int32) |
關於此成員的描述,請參見 GetData(Int32)。 (繼承來源 DbDataReader) |