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呼び出して新しい DataRow をDataTable作成します。
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 内の実際 DataRow のオブジェクトを DataTable表し、 DataColumnCollection には のスキーマを DataColumn 記述するオブジェクトが DataTable含まれています。 オーバーロードされた Item[] プロパティを使用して、 の DataColumn値を取得または設定します。
プロパティと プロパティをHasVersion使用して、特定の行値の状態を確認し、 プロパティをRowState使用して、親 DataTableに対する行の状態を確認IsNullします。
新 DataRowしい を作成するには、 オブジェクトの NewRow メソッドを DataTable 使用します。 新 DataRowしい を作成した後、 メソッドを Add 使用して、 に新しい DataRow を追加します DataRowCollection。 最後に、 オブジェクトの メソッドをAcceptChangesDataTable呼び出して、追加を確認します。 にデータを追加する方法の詳細については、「DataTable へのDataTableデータの追加」を参照してください。
から をDataRow削除する場合は、 の メソッドDataRowCollectionをRemove呼び出すか、 オブジェクトの メソッドをDeleteDataRow呼び出DataRowCollectionします。 メソッドは 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 とのリレーションシップに関する、行の現在の状態を取得します。 |
| Table |
この行のスキーマが関連する DataTable を取得します。 |
メソッド
拡張メソッド
適用対象
スレッド セーフ
この型は、マルチスレッド読み取り操作に安全です。 書き込み操作は同期する必要があります。
こちらもご覧ください
.NET