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

데이터가 들어 있는 DataColumn입니다.A DataColumn that contains the data.

속성 값

데이터가 포함된 Object입니다.An 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. 두 번째 인수로 서 메서드에 전달 된 값을 설정 합니다.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.

속성 값

데이터가 포함된 Object입니다.An 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.

속성 값

데이터가 포함된 Object입니다.An 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.

설정한 값에 대해 해당 TypeDataType과 일치하지 않는 경우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. 두 번째 인수로 서 메서드에 전달 된 값을 설정 합니다.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

열에 대한 정보가 들어 있는 DataColumn입니다.A DataColumn that contains information about the column.

version
DataRowVersion DataRowVersion DataRowVersion DataRowVersion

원하는 행 버전을 지정하는 DataRowVersion 값 중 하나입니다.One of the DataRowVersion values that specifies the row version that you want. 가능한 값은 Default, Original, CurrentProposed입니다.Possible values are Default, Original, Current, and Proposed.

속성 값

데이터가 포함된 Object입니다.An 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 값 중 하나입니다.One of the DataRowVersion values that specifies the row version that you want. 가능한 값은 Default, Original, CurrentProposed입니다.Possible values are Default, Original, Current, and Proposed.

속성 값

데이터가 포함된 Object입니다.An 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 개체에 추가 됩니다 합니다 DataRowCollection; EndEdit 메서드는 다음 메서드를 호출할 때 암시적으로 호출 됩니다:는 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 값 중 하나입니다.One of the DataRowVersion values that specifies the row version that you want. 가능한 값은 Default, Original, CurrentProposed입니다.Possible values are Default, Original, Current, and Proposed.

속성 값

데이터가 포함된 Object입니다.An 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.

추가 정보

적용 대상