DataRow.Item[String, DataRowVersion] DataRow.Item[String, DataRowVersion] DataRow.Item[String, DataRowVersion] DataRow.Item[String, DataRowVersion] Property

定義

オーバーロード

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

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

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

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

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

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

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[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[String, DataRowVersion] Item[String, DataRowVersion] Item[String, DataRowVersion] Item[String, DataRowVersion]

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

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

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

public:
 property System::Object ^ default[System::Data::DataColumn ^] { System::Object ^ get(System::Data::DataColumn ^ column); void set(System::Data::DataColumn ^ column, System::Object ^ value); };
public object this[System.Data.DataColumn column] { get; set; }
member this.Item(System.Data.DataColumn) : obj with get, set
Default Public Property Item(column As DataColumn) As Object

パラメーター

column
DataColumn DataColumn DataColumn DataColumn

データが格納されている DataColumnA DataColumn that contains the data.

プロパティ値

データを格納している ObjectAn Object that contains the data.

例外

この列はこのテーブルに属していません。The column does not belong to this table.

削除した行に値を設定しようとしました。An attempt was made to set a value on a deleted row.

列と値のデータ型が一致しません。The data types of the value and the column do not match.

次の例では、使用、Item[String, DataRowVersion]プロパティを取得し、特定の列インデックスの値を設定します。The following examples demonstrate the use of the Item[String, DataRowVersion] property to get and set the value of a specific column index. 最初の例では、ユーザーがクリックされる行の最初の列の値を取得する、DataGridコントロール。The first example gets the value of the first column in any row that a user clicks in a DataGrid control. 2 つ目は、メソッドに引数として渡された値を設定します。The second sets a value passed as an argument to the method.

Private Sub DataGrid1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs)
    
    Dim dataGridTable As DataTable = _
        CType(DataGrid1.DataSource, DataTable)
    ' Set the current row using the RowNumber 
    ' property of the CurrentCell.
    Dim currentRow As DataRow = _
        dataGridTable.Rows(DataGrid1.CurrentCell.RowNumber)
    Dim column As DataColumn = dataGridTable.Columns(1)

    ' Get the value of the column 1 in the DataTable.
    label1.Text = currentRow(column).ToString()
End Sub
 
Private Sub SetDataRowValue( _
    ByVal grid As DataGrid, ByVal newVal As Object)

    ' Set the value of a column in the last row of a DataGrid.
    Dim table As DataTable = CType(grid.DataSource, DataTable)
    Dim row As DataRow = table.Rows(table.Rows.Count - 1)
    Dim column As DataColumn = table.Columns("FirstName")
    row(column)= newVal
End Sub

注釈

例外が発生した場合、例外が生成されるプロパティを設定すると、ColumnChangingイベント。When you set the property, an exception is generated if an exception occurs in the ColumnChanging event.

直前の編集の場合を参照してください。 EndEdit 、生成される例外。If this is an immediate edit, see EndEdit for the exceptions that can be generated.

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

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

public:
 property System::Object ^ default[int] { System::Object ^ get(int columnIndex); void set(int columnIndex, System::Object ^ value); };
public object this[int columnIndex] { get; set; }
member this.Item(int) : obj with get, set
Default Public Property Item(columnIndex As Integer) As Object

パラメーター

columnIndex
Int32 Int32 Int32 Int32

列の 0 から始まるインデックス番号。The zero-based index of the column.

プロパティ値

データを格納している ObjectAn Object that contains the data.

例外

削除した行に値を設定しようとしたときに発生します。Occurs when you try to set a value on a deleted row.

引数 columnIndex が範囲外です。The columnIndex argument is out of range.

値を設定したときに、新しい値の Type の設定が DataType と一致しない場合に発生します。Occurs when you set the value and the new value's Type does not match DataType.

次の例では、使用、Item[String, DataRowVersion]プロパティを取得し、特定の列インデックスの値を設定します。The following examples demonstrate the use of the Item[String, DataRowVersion] property to get and set the value of a specific column index. 最初の例では、ユーザーがクリックされる行の最初の列の値を取得する、DataGridコントロール。The first example gets the value of the first column in any row that a user clicks in a DataGrid control.

private void DataGrid1_Click(object sender, 
    System.EventArgs e)
{
    // Get the DataTable the grid is bound to.
    DataGrid thisGrid = (DataGrid) sender;
    DataTable table = (DataTable) thisGrid.DataSource;
    DataRow currentRow = 
        table.Rows[thisGrid.CurrentCell.RowNumber];

    // Get the value of the column 1 in the DataTable.
    Console.WriteLine(currentRow[1]);
    // You can also use the name of the column:
    // Console.WriteLine(currentRow["FirstName"])
}

private void SetDataRowValue(DataGrid grid, object newValue)
{
    // Set the value of the last column in the last row of a DataGrid.
    DataTable table;
    table = (DataTable) grid.DataSource;
    DataRow row;

    // Get last row
    row = (DataRow)table.Rows[table.Rows.Count-1];

    // Set value of last column
    row[table.Columns.Count-1] = newValue;
}
Private Sub DataGrid1_Click _
    (ByVal sender As System.Object, ByVal e As System.EventArgs)

    ' Get the DataTable the grid is bound to.
    Dim thisGrid As DataGrid = CType(sender, DataGrid)
    Dim table As DataTable = CType(thisGrid.DataSource, DataTable)
    Dim currentRow As DataRow = _
        table.Rows(thisGrid.CurrentCell.RowNumber)

    ' Get the value of the column 1 in the DataTable.
    Console.WriteLine(currentRow(1))
    ' You can also use the name of the column:
    ' Console.WriteLine(currentRow("FirstName"))
    End Sub

    Private Sub SetDataRowValue( _
        ByVal grid As DataGrid, ByVal newValue As Object)

    ' Set the value of the last column in the last row of a DataGrid.
    Dim table As DataTable
    table = CType(grid.DataSource, DataTable)
    Dim row As DataRow 
    row = table.Rows(table.Rows.Count-1)
    row(table.Columns.Count-1) = newValue
End Sub

注釈

例外が発生した場合、例外が生成されるプロパティを設定すると、ColumnChangingイベント。When you set the property, an exception is generated if an exception occurs in the ColumnChanging event.

編集する場合を参照してください。 EndEdit 、生成される例外。If this is an edit, see EndEdit for the exceptions that can be generated.

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

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

public:
 property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ columnName); void set(System::String ^ columnName, System::Object ^ value); };
public object this[string columnName] { get; set; }
member this.Item(string) : obj with get, set
Default Public Property Item(columnName As String) As Object

パラメーター

columnName
String String String String

列の名前。The name of the column.

プロパティ値

データを格納している ObjectAn Object that contains the data.

例外

columnName で指定した列が見つかりません。The column specified by columnName cannot be found.

削除した行に値を設定しようとしたときに発生します。Occurs when you try to set a value on a deleted row.

値を設定したときに、その値の Type の設定が DataType と一致していない場合に発生します。Occurs when you set a value and its Type does not match DataType.

AllowDBNullfalse に設定されている列に Null 値を挿入したときに発生します。Occurs when you try to insert a null value into a column where AllowDBNull is set to false.

次の例では、使用、Item[String, DataRowVersion]プロパティを取得し、特定の列インデックスの値を設定します。The following examples demonstrate the use of the Item[String, DataRowVersion] property to get and set the value of a specific column index. 最初の例では、ユーザーがクリックされる行の最初の列の値を取得する、DataGridコントロール。The first example gets the value of the first column in any row that a user clicks in a DataGrid control. 2 つ目は、メソッドに引数として渡された値を設定します。The second sets a value passed as an argument to the method.

private void DataGrid1_Click(
    object sender, System.EventArgs e)
{
    // Get the DataTable the grid is bound to.
    DataGrid thisGrid = (DataGrid) sender;
    DataTable table = (DataTable) thisGrid.DataSource;
    DataRow currentRow = 
        table.Rows[thisGrid.CurrentCell.RowNumber];

    // Get the value of the column 1 in the DataTable.
    Console.WriteLine(currentRow["FirstName"]);
    // You can also use the index:
    // Console.WriteLine(currentRow[1]);
}

private void SetDataRowValue(
    DataGrid grid, object newValue)
{
    // Set the value of the first column in 
    // the last row of a DataGrid.
    DataTable table = (DataTable) grid.DataSource;
    DataRow row = table.Rows[table.Rows.Count-1];
    row["FirstName"] = newValue;
}
Private Sub DataGrid1_Click( _
    sender As Object, e As System.EventArgs)
     
    ' Get the DataTable the grid is bound to.
    Dim thisGrid As DataGrid = CType(sender, DataGrid)
    Dim table As DataTable = _
        CType(thisGrid.DataSource, DataTable)
    Dim currentRow As DataRow = _
        table.Rows(thisGrid.CurrentCell.RowNumber)

    ' Get the value of the column 1 in the DataTable.
    Console.WriteLine(currentRow("FirstName"))
    ' You can also use the index:
    ' Console.WriteLine(currentRow(1).ToString())
End Sub
    
Private Sub SetDataRowValue( _
    grid As DataGrid, newValue As Object)
    ' Set the value of the first column in 
    ' the last row of a DataGrid.
    Dim table As DataTable = _
        CType(grid.DataSource, DataTable)
    Dim row As DataRow
    row = table.Rows((table.Rows.Count - 1))
    row("FirstName") = newValue
End Sub

注釈

例外が発生した場合、例外が生成されるプロパティを設定すると、ColumnChangingイベント。When you set the property, an exception is generated if an exception occurs in the ColumnChanging event.

直前の編集の場合を参照してください。 EndEdit 、生成される例外。If this is an immediate edit, see EndEdit for the exceptions that can be generated.

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

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

public:
 property System::Object ^ default[System::Data::DataColumn ^, System::Data::DataRowVersion] { System::Object ^ get(System::Data::DataColumn ^ column, System::Data::DataRowVersion version); };
public object this[System.Data.DataColumn column, System.Data.DataRowVersion version] { get; }
member this.Item(System.Data.DataColumn * System.Data.DataRowVersion) : obj
Default Public ReadOnly Property Item(column As DataColumn, version As DataRowVersion) As Object

パラメーター

column
DataColumn DataColumn DataColumn DataColumn

列に関する情報を格納する DataColumnA DataColumn that contains information about the column.

version
DataRowVersion DataRowVersion DataRowVersion DataRowVersion

行のバージョンを指定する DataRowVersion 値の 1 つ。One of the DataRowVersion values that specifies the row version that you want. 指定できる値は、DefaultOriginalCurrent、および Proposed です。Possible values are Default, Original, Current, and Proposed.

プロパティ値

データを格納している ObjectAn Object that contains the data.

例外

行がこのテーブルに属していません。The column does not belong to the table.

引数 column が null です。The column argument contains null.

このバージョンのデータが行にありません。The row does not have this version of data.

次の例でクリックされたセルの現在の値を取得する、DataGridコントロール。The following example gets the current value of a clicked cell in the DataGrid control.

private void DataGrid1_Click(object sender, 
    System.EventArgs e) 
{
    DataTable dataGridTable = 
        (DataTable)DataGrid1.DataSource;

    // Set the current row using the RowNumber 
    // property of the CurrentCell.
    DataRow currentRow = dataGridTable.Rows[DataGrid1.CurrentCell.RowNumber];
    DataColumn column = dataGridTable.Columns[1];

    // Get the value of the column 1 in the DataTable.
    Console.WriteLine(currentRow[column, DataRowVersion.Current]);
}
Private Sub DataGrid1_Click _
    (ByVal sender As System.Object, ByVal e As System.EventArgs)

    Dim dataGridTable As DataTable = _
        CType(DataGrid1.DataSource, DataTable)

    ' Set the current row using the RowNumber 
    ' property of the CurrentCell.
    Dim currentRow As DataRow = dataGridTable.Rows( _
        DataGrid1.CurrentRowIndex)
    Dim column As DataColumn = dataGridTable.Columns(1)

    ' Get the value of the column 1 in the DataTable.
    label1.Text = currentRow(column, _
        DataRowVersion.Current).ToString()
End Sub

注釈

versionと混同しない場合があります、RowStateプロパティ。The version should not be confused with the RowState property. version引数が列の元の値を基準列に格納されているデータの状態について説明します。The version argument describes the state of the data that is contained by the column relative to the column's original value.

例外が発生した場合、例外が生成されるプロパティを設定すると、ColumnChangingイベント。When you set the property, an exception is generated if an exception occurs in the ColumnChanging event.

直前の編集の場合を参照してください。 EndEdit 、生成される例外。If this is an immediate edit, see EndEdit for the exceptions that can be generated.

こちらもご覧ください

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.

public:
 property System::Object ^ default[int, System::Data::DataRowVersion] { System::Object ^ get(int columnIndex, System::Data::DataRowVersion version); };
public object this[int columnIndex, System.Data.DataRowVersion version] { get; }
member this.Item(int * System.Data.DataRowVersion) : obj
Default Public ReadOnly Property Item(columnIndex As Integer, version As DataRowVersion) As Object

パラメーター

columnIndex
Int32 Int32 Int32 Int32

列の 0 から始まるインデックス番号。The zero-based index of the column.

version
DataRowVersion DataRowVersion DataRowVersion DataRowVersion

行のバージョンを指定する DataRowVersion 値の 1 つ。One of the DataRowVersion values that specifies the row version that you want. 指定できる値は、DefaultOriginalCurrent、および Proposed です。Possible values are Default, Original, Current, and Proposed.

プロパティ値

データを格納している ObjectAn Object that contains the data.

例外

引数 columnIndex が範囲外です。The columnIndex argument is out of range.

列と値のデータ型が一致しません。The data types of the value and the column do not match.

このバージョンのデータが行にありません。The row does not have this version of data.

削除した行に値を設定しようとしました。An attempt was made to set a value on a deleted row.

次の例は、列からの現在の値を取得、Item[String, DataRowVersion]のプロパティ、DataRowオブジェクト。The following example gets the current value of a column through the Item[String, DataRowVersion] property of the DataRow object.

Private Sub DataGrid1_Click _
    (ByVal sender As System.Object, ByVal e As System.EventArgs)
    
    ' Set the current row using the RowNumber property of the CurrentCell.
    Dim currentRow As DataRow = CType(DataGrid1.DataSource, DataTable). _
       Rows(DataGrid1.CurrentCell.RowNumber)

    ' Get the value of the column 1 in the DataTable.
    label1.Text = currentRow(1, DataRowVersion.Current).ToString()
End Sub

注釈

作成または呼び出し後は、行を更新することができますのみ、BeginEditメソッドは同様に、EndEdit編集をコミットするメソッドを呼び出す必要があります。You can only create or update a row after you call the BeginEdit method; similarly, the EndEdit method must be called to commit the edit. 呼び出した後、EndEditメソッドを呼び出す前に、AcceptChangesメソッド、元のおよび新しい内部表現を提案値が格納されています。After you call the EndEdit method, and before you call the AcceptChanges method, internal representations of the original and new proposed values are stored. そのため、呼び出すまで、 AcceptChanges、使用することができます、version列の値のバージョンを必要があるかを指定する引数、DataRowVersion.OriginalまたはDataRowVersion.Proposedします。Therefore, until you call the AcceptChanges, you can use the version argument to specify which version of a column's value you need, either the DataRowVersion.Original or DataRowVersion.Proposed. ただし、として呼び出すことがすぐに、AcceptChangesメソッドに、列のバージョンを元に戻しますDataRowVersion.Originalします。However, as soon as you call the AcceptChanges method, the version of the column reverts to DataRowVersion.Original. 渡すことも、行が新しい場合は、DataRowVersion.Default列の既定値を取得するパラメーター。If the row is new, you can also pass DataRowVersion.Default for the parameter to retrieve the column's default value. 渡すときにDataRowVersion.Currentプロパティは、現在を返して値、そのバージョンであらゆる可能性があります。When passing DataRowVersion.Current, the property returns the current value, whatever its version may be.

注意

BeginEditメソッドは、データ バインド コントロールの値を変更するとき、または暗黙的に呼び出されます、DataRowオブジェクトに追加されます、 DataRowCollectionEndEditメソッドは、次のメソッドを呼び出すときに暗黙的に呼び出されます、 AcceptChanges 。メソッド、DataRowオブジェクト、AcceptChangesのメソッド、DataTableオブジェクト、またはCancelEditメソッド。The BeginEdit method is called implicitly when you change the value of a data-bound control or when a DataRow object is added to the DataRowCollection; the EndEdit method is called implicitly when you call the following methods: the AcceptChanges method of the DataRow object, the AcceptChanges method of the DataTable object, or the CancelEdit method.

これに対し、DataRowVersion列挙Current後のデータのバージョンを返します、EndEditメソッドが呼び出されました。By contrast, the DataRowVersion enumeration Current returns the version of the data after the EndEdit method has been called.

versionと引数を混同しない必要があります、RowStateプロパティ。The version argument should not be confused with the RowState property. version引数が列の元の値を基準列に格納されているデータの状態について説明します。The version argument describes the state of the data that is contained by the column relative to the column's original value. RowStateプロパティは、その親に相対行全体の状態を説明します。DataTableします。The RowState property describes the state of the whole row relative to its parent DataTable.

例外が発生した場合、例外が生成されるプロパティを設定すると、ColumnChangingイベント。When you set the property, an exception is generated if an exception occurs in the ColumnChanging event.

直前の編集の場合を参照してください。 EndEdit 、生成される例外。If this is an immediate edit, see EndEdit for the exceptions that can be generated.

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

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

public:
 property System::Object ^ default[System::String ^, System::Data::DataRowVersion] { System::Object ^ get(System::String ^ columnName, System::Data::DataRowVersion version); };
public object this[string columnName, System.Data.DataRowVersion version] { get; }
member this.Item(string * System.Data.DataRowVersion) : obj
Default Public ReadOnly Property Item(columnName As String, version As DataRowVersion) As Object

パラメーター

columnName
String String String String

列の名前。The name of the column.

version
DataRowVersion DataRowVersion DataRowVersion DataRowVersion

行のバージョンを指定する DataRowVersion 値の 1 つ。One of the DataRowVersion values that specifies the row version that you want. 指定できる値は、DefaultOriginalCurrent、および Proposed です。Possible values are Default, Original, Current, and Proposed.

プロパティ値

データを格納している ObjectAn Object that contains the data.

例外

columnName で指定した列が見つかりません。The column specified by columnName cannot be found.

列と値のデータ型が一致しません。The data types of the value and the column do not match.

このバージョンのデータが行にありません。The row does not have this version of data.

次の例では、データの現在のバージョンを取得でのセルがクリックされた、DataGridコントロール。The following example gets the current version of data at a clicked cell of a DataGrid control.

private void DataGrid1_Click(object sender, System.EventArgs e)
{
    // Set the current row using the RowNumber 
    // property of the CurrentCell.
    DataRow currentRow =
        ((DataTable)(DataGrid1.DataSource)).
        Rows[DataGrid1.CurrentCell.RowNumber];

    // Print the current value of the column named "FirstName."
    Console.WriteLine(currentRow["FirstName", 
        DataRowVersion.Current]);
}
Private Sub DataGrid1_Click _
    (ByVal sender As System.Object, ByVal e As System.EventArgs)
    
    ' Set the current row using the RowNumber property 
    ' of the CurrentCell.
    Dim currentRow As DataRow = _
        CType(DataGrid1.DataSource, DataTable). _
        Rows(DataGrid1.CurrentCell.RowNumber)

    ' Print the current value of the column named "FirstName."
    Console.WriteLine(currentRow("FirstName", _
        DataRowVersion.Current).ToString())
End Sub

注釈

バージョンする必要がありますと混同しないで、RowStateプロパティ。The version should not be confused with the RowState property. version引数が列の元の値を基準列に格納されているデータの状態について説明します。The version argument describes the state of the data that is contained by the column relative to the column's original value. RowStateプロパティは、その親に相対行全体の状態を説明します。DataTableします。The RowState property describes the state of the whole row relative to its parent DataTable.

例外が発生した場合、例外が生成されるプロパティを設定すると、ColumnChangingイベント。When you set the property, an exception is generated if an exception occurs in the ColumnChanging event.

直前の編集の場合を参照してください。 EndEdit 、生成される例外。If this is an immediate edit, see EndEdit for the exceptions that can be generated.

こちらもご覧ください

適用対象