DataRow クラス

定義

public ref class DataRow

public class DataRow

[System.Serializable]
public class DataRow

type DataRow = class

[<System.Serializable>]
type DataRow = class

Public Class DataRow

継承

Object

DataRow

属性

SerializableAttribute

例

次の例では、 オブジェクトの メソッドを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 の削除」を参照してください。

コンストラクター

プロパティ

メソッド

拡張メソッド

適用対象

スレッド セーフ

この型は、マルチスレッド読み取り操作に安全です。 書き込み操作は同期する必要があります。

こちらもご覧ください

• AcceptChanges()
• Add(DataRow)
• DataColumnCollection
• DataColumn
• DataRowView
• DataTable
• HasVersion(DataRowVersion)
• IsNull(Int32)
• Item[Int32]
• NewRow()
• DataRowCollection
• ADO.NET でのデータセットの使用