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 DataTableオブジェクトのNewRowメソッドを呼び出すことによって、新しいを作成します。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

注釈

オブジェクトDataRow DataTableDataColumnオブジェクトは、の主要なコンポーネントです。The DataRow and DataColumn objects are primary components of a DataTable. オブジェクトとそのプロパティとメソッドを使用して、のDataTable値を取得および評価し、その値を挿入、削除、および更新します。 DataRowUse the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. DataRow DataColumnCollection DataColumn DataTableは内DataRowCollection の実際のオブジェクトを表し、にはのスキーマを記述するオブジェクトが含まれ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.

RowState DataTableプロパティとプロパティIsNullを使用して、特定の行の値の状態を判断し、プロパティを使用して、その親を基準とした行の状態を判断します。 HasVersionUse 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. 最後に、 DataTableオブジェクトAcceptChangesのメソッドを呼び出して、追加を確認します。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 Remove DataRowCollectionメソッドをDataRowCollection呼び出すか、オブジェクトDataRowのメソッドを呼び出すことによって、からを削除できます。 DeleteYou 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)

拡張メソッド

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.

こちらもご覧ください