DataRow 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示 DataTable 中的資料列。
public ref class DataRowpublic class DataRow[System.Serializable]
public class DataRowtype DataRow = class[<System.Serializable>]
type DataRow = classPublic Class DataRow- 繼承
-
DataRow
- 屬性
範例
下列範例會呼叫 NewRow 物件的 方法DataTable，以建立新的 DataRow 。
private void CreateNewDataRow()
{
// Use the MakeTable function below to create a new table.
DataTable table;
table = MakeNamesTable();
// Once a table has been created, use the
// NewRow to create a DataRow.
DataRow row;
row = table.NewRow();
// Then add the new row to the collection.
row["fName"] = "John";
row["lName"] = "Smith";
table.Rows.Add(row);
foreach(DataColumn column in table.Columns)
Console.WriteLine(column.ColumnName);
dataGrid1.DataSource=table;
}
private DataTable MakeNamesTable()
{
// Create a new DataTable titled 'Names.'
DataTable namesTable = new DataTable("Names");
// Add three column objects to the table.
DataColumn idColumn = new DataColumn();
idColumn.DataType = System.Type.GetType("System.Int32");
idColumn.ColumnName = "id";
idColumn.AutoIncrement = true;
namesTable.Columns.Add(idColumn);
DataColumn fNameColumn = new DataColumn();
fNameColumn.DataType = System.Type.GetType("System.String");
fNameColumn.ColumnName = "Fname";
fNameColumn.DefaultValue = "Fname";
namesTable.Columns.Add(fNameColumn);
DataColumn lNameColumn = new DataColumn();
lNameColumn.DataType = System.Type.GetType("System.String");
lNameColumn.ColumnName = "LName";
namesTable.Columns.Add(lNameColumn);
// Create an array for DataColumn objects.
DataColumn [] keys = new DataColumn [1];
keys[0] = idColumn;
namesTable.PrimaryKey = keys;
// Return the new DataTable.
return namesTable;
}
Private Sub CreateNewDataRow()
' Use the MakeTable function below to create a new table.
Dim table As DataTable
table = MakeNamesTable()
' Once a table has been created, use the
' NewRow to create a DataRow.
Dim row As DataRow
row = table.NewRow()
' Then add the new row to the collection.
row("fName") = "John"
row("lName") = "Smith"
table.Rows.Add(row)
Dim column As DataColumn
For Each column in table.Columns
Console.WriteLine(column.ColumnName)
Next
DataGrid1.DataSource=table
End Sub
Private Function MakeNamesTable() As DataTable
' Create a new DataTable titled 'Names.'
Dim namesTable As New DataTable("Names")
' Add three column objects to the table.
Dim idColumn As New DataColumn()
idColumn.DataType = System.Type.GetType("System.Int32")
idColumn.ColumnName = "id"
idColumn.AutoIncrement = True
namesTable.Columns.Add(idColumn)
Dim fNameColumn As New DataColumn()
fNameColumn.DataType = System.Type.GetType("System.String")
fNameColumn.ColumnName = "Fname"
fNameColumn.DefaultValue = "Fname"
namesTable.Columns.Add(fNameColumn)
Dim lNameColumn As New DataColumn()
lNameColumn.DataType = System.Type.GetType("System.String")
lNameColumn.ColumnName = "LName"
namesTable.Columns.Add(lNameColumn)
' Create an array for DataColumn objects.
Dim keys(0) As DataColumn
keys(0) = idColumn
namesTable.PrimaryKey = keys
' Return the new DataTable.
MakeNamesTable = namesTable
End Function
備註
DataRow和 DataColumn 物件是的主要元件DataTable。 DataRow使用物件及其屬性和方法來擷取和評估;以及插入、刪除和更新 中的DataTable值。 DataRowCollection表示 中DataTable的實際DataRow物件，而且 DataColumnCollection 包含DataColumn描述 架構的物件DataTable。 使用多載 Item[] 屬性可傳回或設定的值 DataColumn。
HasVersion使用 和 IsNull 屬性來判斷特定數據列值的狀態，並使用 RowState 屬性來判斷相對於其父DataTable代 的數據列狀態。
若要建立新的 DataRow，請使用 NewRow 物件的方法 DataTable 。 建立新的 DataRow之後，請使用 Add 方法將新的 DataRow 新增至 DataRowCollection。 最後，呼叫 AcceptChanges 物件的方法 DataTable ，以確認新增。 如需將數據新增至 DataTable的詳細資訊，請參閱 將數據新增至 DataTable。
您可以藉由呼叫 Remove 的DataRowCollection方法，或呼叫 Delete 物件的 方法DataRow，從 DataRowCollection 中刪除 DataRow 。 方法 Remove 會從集合中移除數據列。 相反地， Delete 請標示 DataRow 要移除的 。 當您呼叫 AcceptChanges 方法時，就會發生實際的移除。 藉由呼叫 Delete，您可以透過程序設計方式檢查哪些數據列標示為移除，然後再實際刪除它們。 如需詳細資訊，請參閱 DataRow 刪除。
建構函式
| DataRow(DataRowBuilder) |
使用指定的產生器，初始化 DataRow 類別的新實例。 僅供內部使用。 |
屬性
| HasErrors |
取得值，指出資料列中是否有錯誤。 |
| Item[DataColumn, DataRowVersion] |
取得儲存於指定的 DataColumn 中指定版本的資料。 |
| Item[DataColumn] |
取得或設定儲存於指定的 DataColumn 中的資料。 |
| Item[Int32, DataRowVersion] |
取得儲存於資料行中的資料，它是由要擷取的資料索引和版本所指定。 |
| Item[Int32] |
取得或設定儲存於索引指定的資料行中的資料。 |
| Item[String, DataRowVersion] |
取得儲存於具名資料行中指定版本的資料。 |
| Item[String] |
取得或設定儲存於名稱所指定之資料行的資料。 |
| ItemArray |
透過陣列取得或設定這個資料列的所有值。 |
| RowError |
取得或設定資料列的自訂錯誤描述。 |
| RowState |
取得關於資料列與 DataRowCollection 之關聯性 (Relationship) 的資料列目前狀態。 |
| Table |
取得其中的這個資料列具有結構描述的 DataTable。 |
方法
擴充方法
適用於
執行緒安全性
此類型適用於多線程讀取作業。 您必須同步處理任何寫入作業。
