DataRow DataRow DataRow DataRow Class

定義

DataTable 内のデータ行を表します。Represents a row of data in a DataTable.

public ref class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
Public Class DataRow
継承
DataRowDataRowDataRowDataRow
属性

次の例では、作成、新しいDataRow呼び出すことによって、NewRowのメソッド、DataTableオブジェクト。The following example creates a new DataRow by calling the NewRow method of the DataTable object.

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 DataTable = new DataTable("Names") 

    ' Add three column objects to the table.
    Dim idColumn As DataColumn = new  DataColumn()
    idColumn.DataType = System.Type.GetType("System.Int32")
    idColumn.ColumnName = "id"
    idColumn.AutoIncrement = True
    namesTable.Columns.Add(idColumn)

    Dim fNameColumn As DataColumn = New DataColumn()
    fNameColumn.DataType = System.Type.GetType("System.String")
    fNameColumn.ColumnName = "Fname"
    fNameColumn.DefaultValue = "Fname"
    namesTable.Columns.Add(fNameColumn)

    Dim lNameColumn As DataColumn = 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

注釈

DataRowDataColumnオブジェクトは、主要なコンポーネントのDataTableします。The DataRow and DataColumn objects are primary components of a DataTable. 使用して、DataRowオブジェクトのプロパティ、および取得し; を評価し、挿入、削除、およびの値を更新する方法、DataTableします。Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. DataRowCollection 、実際に表しますDataRow内のオブジェクト、 DataTable、およびDataColumnCollectionが含まれています、DataColumnのスキーマを記述するオブジェクト、DataTableします。The DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. オーバー ロードされたを使用して、Item[String, DataRowVersion]プロパティの値を設定する、DataColumnします。Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

使用して、HasVersionIsNullプロパティを確認して、特定の行値の状態とRowStateプロパティをその親の行の状態を確認するDataTableUse the HasVersion and IsNull properties to determine the status of a particular row value, and the RowState property to determine the state of the row relative to its parent DataTable.

新たに作成するDataRowを使用して、NewRowのメソッド、DataTableオブジェクト。To create a new DataRow, use the NewRow method of the DataTable object. 新たに作成した後はDataRowを使用して、Addメソッドを追加する新しいDataRowDataRowCollectionします。After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. 最後に、呼び出し、AcceptChangesのメソッド、DataTable追加を確認するオブジェクト。Finally, call the AcceptChanges method of the DataTable object to confirm the addition. データの追加の詳細については、DataTableを参照してくださいDataTable にデータを追加するします。For more information about adding data to a DataTable, see Adding Data to a DataTable.

削除することができます、DataRowから、DataRowCollection呼び出すことによって、Removeのメソッド、 DataRowCollection、または呼び出すことによって、Deleteのメソッド、DataRowオブジェクト。You can delete a DataRow from the DataRowCollection by calling the Remove method of the DataRowCollection, or by calling the Delete method of the DataRow object. Removeメソッドは、コレクションから行を削除します。The Remove method removes the row from the collection. これに対し、Deleteマーク、DataRow削除します。In contrast, Delete marks the DataRow for removal. 実際の削除を呼び出すときに発生します。AcceptChangesメソッド。The actual removal occurs when you call AcceptChanges method. 呼び出してDelete、実際に削除する前に削除する行がマークされているプログラムによってチェックできます。By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. 詳細については、次を参照してください。 DataRow の削除します。For more information, see DataRow Deletion.

コンストラクター

DataRow(DataRowBuilder) DataRow(DataRowBuilder) DataRow(DataRowBuilder) DataRow(DataRowBuilder)

DataRow の新しいインスタンスを初期化します。Initializes a new instance of the DataRow. ビルダーから行を構築します。Constructs a row from the builder. 内部でのみ使用されます。Only for internal usage.

プロパティ

HasErrors HasErrors HasErrors HasErrors

行にエラーがあるかどうかを示す値を取得します。Gets a value that indicates whether there are errors in a row.

ItemArray ItemArray ItemArray ItemArray

配列を使用してこの行のすべての値を取得または設定します。Gets or sets all the values for this row through an array.

Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion]

指定した DataColumn に格納されているデータの指定したバージョンを取得します。Gets the specified version of data stored in the specified DataColumn.

Item[DataColumn] Item[DataColumn] Item[DataColumn] Item[DataColumn]

指定した DataColumn に格納されているデータを取得または設定します。Gets or sets the data stored in the specified DataColumn.

Item[Int32, DataRowVersion] Item[Int32, DataRowVersion] Item[Int32, DataRowVersion] Item[Int32, DataRowVersion]

列に格納されている、取得するデータのインデックスとバージョンで指定したデータを取得します。Gets the data stored in the column, specified by index and version of the data to retrieve.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

インデックスで指定した列に格納されているデータを取得または設定します。Gets or sets the data stored in the column specified by index.

Item[String, DataRowVersion] Item[String, DataRowVersion] Item[String, DataRowVersion] Item[String, DataRowVersion]

指定した列に格納されているデータの指定したバージョンを取得します。Gets the specified version of data stored in the named column.

Item[String] Item[String] Item[String] Item[String]

名前で指定した列に格納されているデータを取得または設定します。Gets or sets the data stored in the column specified by name.

RowError RowError RowError RowError

行のカスタム エラー説明を取得または設定します。Gets or sets the custom error description for a row.

RowState RowState RowState RowState

DataRowCollection とのリレーションシップに関する、行の現在の状態を取得します。Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table Table Table Table

この行のスキーマが関連する DataTable を取得します。Gets the DataTable for which this row has a schema.

メソッド

AcceptChanges() AcceptChanges() AcceptChanges() AcceptChanges()

前回 AcceptChanges() を呼び出した以降にこの行に対して行われたすべての変更をコミットします。Commits all the changes made to this row since the last time AcceptChanges() was called.

BeginEdit() BeginEdit() BeginEdit() BeginEdit()

DataRow オブジェクトの編集操作を開始します。Starts an edit operation on a DataRow object.

CancelEdit() CancelEdit() CancelEdit() CancelEdit()

この行の現在の編集をキャンセルします。Cancels the current edit on the row.

ClearErrors() ClearErrors() ClearErrors() ClearErrors()

行のエラーを消去します。Clears the errors for the row. これには RowError と、SetColumnError(Int32, String) に設定されているエラーが含まれます。This includes the RowError and errors set with SetColumnError(Int32, String).

Delete() Delete() Delete() Delete()

DataRow を削除します。Deletes the DataRow.

EndEdit() EndEdit() EndEdit() EndEdit()

この行で行われている編集を終了します。Ends the edit occurring on the row.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation)

指定した DataRow を使用して、この DataRelation の子行を取得します。Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion)

指定した DataRowDataRelation を使用して、DataRowVersion の子行を取得します。Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String) GetChildRows(String) GetChildRows(String) GetChildRows(String)

DataRow の指定した RelationName を使用して、DataRelation の子行を取得します。Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion)

DataRow の指定した RelationNameDataRelation を使用して、DataRowVersion の子行を取得します。Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetColumnError(DataColumn) GetColumnError(DataColumn) GetColumnError(DataColumn) GetColumnError(DataColumn)

指定した DataColumn のエラーの説明を取得します。Gets the error description of the specified DataColumn.

GetColumnError(Int32) GetColumnError(Int32) GetColumnError(Int32) GetColumnError(Int32)

インデックスで指定した列のエラーの説明を取得します。Gets the error description for the column specified by index.

GetColumnError(String) GetColumnError(String) GetColumnError(String) GetColumnError(String)

名前で指定した列のエラーの説明を取得します。Gets the error description for a column, specified by name.

GetColumnsInError() GetColumnsInError() GetColumnsInError() GetColumnsInError()

エラーが含まれる列の配列を取得します。Gets an array of columns that have errors.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetParentRow(DataRelation) GetParentRow(DataRelation) GetParentRow(DataRelation) GetParentRow(DataRelation)

指定した DataRow を使用して、DataRelation の親行を取得します。Gets the parent row of a DataRow using the specified DataRelation.

GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion)

指定した DataRowDataRelation を使用して、DataRowVersion の親行を取得します。Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRow(String) GetParentRow(String) GetParentRow(String) GetParentRow(String)

DataRow の指定した RelationName を使用して、DataRelation の親行を取得します。Gets the parent row of a DataRow using the specified RelationName of a DataRelation.

GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion)

DataRow の指定した RelationNameDataRelation を使用して、DataRowVersion の親行を取得します。Gets the parent row of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetParentRows(DataRelation) GetParentRows(DataRelation) GetParentRows(DataRelation) GetParentRows(DataRelation)

指定した DataRow を使用して、DataRelation の親行を取得します。Gets the parent rows of a DataRow using the specified DataRelation.

GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion)

指定した DataRowDataRelation を使用して、DataRowVersion の親行を取得します。Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String) GetParentRows(String) GetParentRows(String) GetParentRows(String)

DataRow の指定した RelationName を使用して、DataRelation の親行を取得します。Gets the parent rows of a DataRow using the specified RelationName of a DataRelation.

GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion)

DataRow の指定した RelationNameDataRelation を使用して、DataRowVersion の親行を取得します。Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
HasVersion(DataRowVersion) HasVersion(DataRowVersion) HasVersion(DataRowVersion) HasVersion(DataRowVersion)

指定したバージョンが存在するかどうかを示す値を取得します。Gets a value that indicates whether a specified version exists.

IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn)

指定した DataColumn に null 値が格納されているかどうかを示す値を取得します。Gets a value that indicates whether the specified DataColumn contains a null value.

IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion)

指定した DataColumnDataRowVersion に null 値が格納されているかどうかを示す値を取得します。Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

IsNull(Int32) IsNull(Int32) IsNull(Int32) IsNull(Int32)

指定したインデックス位置にある列に null 値が格納されているかどうかを示す値を取得します。Gets a value that indicates whether the column at the specified index contains a null value.

IsNull(String) IsNull(String) IsNull(String) IsNull(String)

指定した列に null 値が格納されているかどうかを示す値を取得します。Gets a value that indicates whether the named column contains a null value.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
RejectChanges() RejectChanges() RejectChanges() RejectChanges()

前回 AcceptChanges() を呼び出した以降にこの行に対して行われたすべての変更を拒否します。Rejects all changes made to the row since AcceptChanges() was last called.

SetAdded() SetAdded() SetAdded() SetAdded()

RowStateDataRowAdded に変更します。Changes the RowState of a DataRow to Added.

SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String)

DataColumn として指定した列のエラーの説明を設定します。Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String)

インデックスで指定した列のエラーの説明を設定します。Sets the error description for a column specified by index.

SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String)

名前で指定した列のエラーの説明を設定します。Sets the error description for a column specified by name.

SetModified() SetModified() SetModified() SetModified()

RowStateDataRowModified に変更します。Changes the RowState of a DataRow to Modified.

SetNull(DataColumn) SetNull(DataColumn) SetNull(DataColumn) SetNull(DataColumn)

指定した DataColumn の値を null 値に設定します。Sets the value of the specified DataColumn to a null value.

SetParentRow(DataRow) SetParentRow(DataRow) SetParentRow(DataRow) SetParentRow(DataRow)

指定した新しい親 DataRow を使用して、DataRow の親行を設定します。Sets the parent row of a DataRow with specified new parent DataRow.

SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation)

指定した新しい親 DataRowDataRow を使用して、DataRelation の親行を設定します。Sets the parent row of a DataRow with specified new parent DataRow and DataRelation.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

Extension Methods

Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn, DataRowVersion) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32, DataRowVersion) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String) Field<T>(DataRow, String) Field<T>(DataRow, String) Field<T>(DataRow, String)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String, DataRowVersion) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T)

DataRow 内の指定された列に新しい値を設定します。Sets a new value for the specified column in the DataRow. SetField<T>(DataRow, DataColumn, T) メソッドは Null 許容型もサポートします。The SetField<T>(DataRow, DataColumn, T) method also supports nullable types.

SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T)

メソッドを呼び出した DataRow 内の指定された列に新しい値を設定します。Sets a new value for the specified column in the DataRow the method is called on. SetField<T>(DataRow, Int32, T) メソッドは Null 許容型もサポートします。The SetField<T>(DataRow, Int32, T) method also supports nullable types.

SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T)

DataRow 内の指定された列に新しい値を設定します。Sets a new value for the specified column in the DataRow. SetField<T>(DataRow, String, T) メソッドは Null 許容型もサポートします。The SetField<T>(DataRow, String, T) method also supports nullable types.

適用対象

スレッド セーフ

この型は、マルチ スレッドの読み取り操作も安全です。This type is safe for multithreaded read operations. 書き込み操作を同期する必要があります。You must synchronize any write operations.

こちらもご覧ください