DataRow.Item[] Özellik

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Belirtilen sütunda depolanan verileri alır veya ayarlar.

Aşırı Yüklemeler

Item[DataColumn]	Belirtilen DataColumniçinde depolanan verileri alır veya ayarlar.
Item[Int32]	Dizin tarafından belirtilen sütunda depolanan verileri alır veya ayarlar.
Item[String]	Adla belirtilen sütunda depolanan verileri alır veya ayarlar.
Item[DataColumn, DataRowVersion]	Belirtilen içinde depolanan verilerin belirtilen DataColumnsürümünü alır.
Item[Int32, DataRowVersion]	Alınacak verilerin dizini ve sürümüyle belirtilen sütunda depolanan verileri alır.
Item[String, DataRowVersion]	Adlandırılmış sütunda depolanan verilerin belirtilen sürümünü alır.

Item[DataColumn]

Kaynak:

DataRow.cs

Belirtilen DataColumniçinde depolanan verileri alır veya ayarlar.

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

Parametreler

column

DataColumn

DataColumn Verileri içeren bir.

Özellik Değeri

Object

Object Verileri içeren bir.

Özel durumlar

ArgumentException

Sütun bu tabloya ait değil.

ArgumentNullException

column null değeridir.

DeletedRowInaccessibleException

Silinen bir satırda değer ayarlama girişiminde bulunuldu.

InvalidCastException

Değerin ve sütunun veri türleri eşleşmiyor.

Örnekler

Aşağıdaki örneklerde, belirli bir sütun dizininin Item[] değerini almak ve ayarlamak için özelliğinin kullanımı gösterilmektedir. İlk örnek, bir kullanıcının denetimde tıklattığını herhangi bir satırdaki ilk sütunun DataGrid değerini alır. İkincisi, yöntemine bağımsız değişken olarak geçirilen bir değeri ayarlar.

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

Açıklamalar

özelliğini ayarladığınızda, olayda ColumnChanging bir özel durum oluşursa bir özel durum oluşturulur.

Bu hemen bir düzenlemeyse, oluşturulabilecek özel durumlar için bkz EndEdit .

Item[Int32]

Kaynak:

DataRow.cs

Dizin tarafından belirtilen sütunda depolanan verileri alır veya ayarlar.

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

Parametreler

columnIndex

Int32

Sütunun sıfır tabanlı dizini.

Özellik Değeri

Object

Object Verileri içeren bir.

Özel durumlar

DeletedRowInaccessibleException

Silinen satırda bir değer ayarlamaya çalıştığınızda gerçekleşir.

IndexOutOfRangeException

Bağımsız columnIndex değişken aralık dışında.

InvalidCastException

Değeri ayarladığınızda ve yeni değerin Type değerleri ile eşleşmediğinde DataTypegerçekleşir.

Örnekler

Aşağıdaki örneklerde, belirli bir sütun dizininin Item[] değerini almak ve ayarlamak için özelliğinin kullanımı gösterilmektedir. İlk örnek, bir kullanıcının denetimde tıklattığını herhangi bir satırdaki ilk sütunun DataGrid değerini alır.

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

Açıklamalar

özelliğini ayarladığınızda, olayda ColumnChanging bir özel durum oluşursa bir özel durum oluşturulur.

Bu bir düzenlemeyse, oluşturulabilecek özel durumlar için bkz EndEdit .

Item[String]

Kaynak:

DataRow.cs

Adla belirtilen sütunda depolanan verileri alır veya ayarlar.

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

Parametreler

columnName

String

Sütunun adı.

Özellik Değeri

Object

Object Verileri içeren bir.

Özel durumlar

ArgumentException

tarafından columnName belirtilen sütun bulunamıyor.

DeletedRowInaccessibleException

Silinen satırda bir değer ayarlamaya çalıştığınızda gerçekleşir.

InvalidCastException

Bir değer ayarladığınızda ve değeri Type ile eşleşmediğinde DataTypegerçekleşir.

NoNullAllowedException

olarak ayarlanmış falsebir sütuna AllowDBNull null değer eklemeye çalıştığınızda gerçekleşir.

Örnekler

Aşağıdaki örneklerde, belirli bir sütun dizininin Item[] değerini almak ve ayarlamak için özelliğinin kullanımı gösterilmektedir. İlk örnek, bir kullanıcının denetimde tıklattığını herhangi bir satırdaki ilk sütunun DataGrid değerini alır. İkincisi, yöntemine bağımsız değişken olarak geçirilen bir değeri ayarlar.

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

Açıklamalar

özelliğini ayarladığınızda, olayda ColumnChanging bir özel durum oluşursa bir özel durum oluşturulur.

Bu hemen bir düzenlemeyse, oluşturulabilecek özel durumlar için bkz EndEdit .

Item[DataColumn, DataRowVersion]

Kaynak:

DataRow.cs

Belirtilen içinde depolanan verilerin belirtilen DataColumnsürümünü alır.

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

Parametreler

column

DataColumn

DataColumn Sütun hakkında bilgi içeren bir.

version

DataRowVersion

DataRowVersion İstediğiniz satır sürümünü belirten değerlerden biri. Olası değerler , Original, Currentve ProposeddeğerleridirDefault.

Özellik Değeri

Object

Object Verileri içeren bir.

Özel durumlar

ArgumentException

Sütun tabloya ait değil.

ArgumentNullException

Bağımsız column değişken null içeriyor.

VersionNotFoundException

Satırda bu sürümde veri yoktur.

Örnekler

Aşağıdaki örnek, denetimdeki tıklanan hücrenin DataGrid geçerli değerini alır.

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

Açıklamalar

version özelliğiyle RowState karıştırılmamalıdır. bağımsız değişkeni, version sütunun özgün değerine göre sütunun içerdiği verilerin durumunu açıklar.

özelliğini ayarladığınızda, olayda ColumnChanging bir özel durum oluşursa bir özel durum oluşturulur.

Bu hemen bir düzenlemeyse, oluşturulabilecek özel durumlar için bkz EndEdit .

Ayrıca bkz.

• DataRowVersion

Item[Int32, DataRowVersion]

Kaynak:

DataRow.cs

Alınacak verilerin dizini ve sürümüyle belirtilen sütunda depolanan verileri alır.

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

Parametreler

columnIndex

Int32

Sütunun sıfır tabanlı dizini.

version

DataRowVersion

DataRowVersion İstediğiniz satır sürümünü belirten değerlerden biri. Olası değerler , Original, Currentve ProposeddeğerleridirDefault.

Özellik Değeri

Object

Object Verileri içeren bir.

Özel durumlar

IndexOutOfRangeException

Bağımsız columnIndex değişken aralık dışında.

InvalidCastException

Değerin ve sütunun veri türleri eşleşmiyor.

VersionNotFoundException

Satırda bu sürümde veri yoktur.

DeletedRowInaccessibleException

Silinen bir satırda değer ayarlama girişiminde bulunuldu.

Örnekler

Aşağıdaki örnek, nesnesinin özelliği aracılığıyla bir sütunun Item[]DataRow geçerli değerini alır.

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

Açıklamalar

Yalnızca yöntemini çağırdıktan BeginEdit sonra bir satır oluşturabilir veya güncelleştirebilirsiniz; benzer şekilde, düzenlemeyi EndEdit işlemek için yönteminin çağrılması gerekir. yöntemini çağırdıktan EndEdit sonra ve yöntemini çağırmadan AcceptChanges önce özgün ve yeni önerilen değerlerin iç gösterimleri depolanır. Bu nedenle, çağırana AcceptChangeskadar bağımsız değişkenini version kullanarak bir sütunun değerinin hangi sürümüne ihtiyacınız DataRowVersion.Original olduğunu (veya DataRowVersion.Proposed) belirtebilirsiniz. Ancak yöntemini çağırdığınızda AcceptChanges sütunun sürümü olarak DataRowVersion.Originalgeri döner. Satır yeniyse, sütunun varsayılan değerini almak için parametresini de geçirebilirsiniz DataRowVersion.Default . geçirildiğinde DataRowVersion.Currentözelliği, sürümü ne olursa olsun geçerli değeri döndürür.

Not

BeginEdit Veriye bağlı denetimin değerini değiştirdiğinizde veya öğesine bir DataRow nesne eklendiğinde DataRowCollectionyöntemi örtük olarak çağrılır; EndEdit aşağıdaki yöntemleri çağırdığınızda yöntem örtük olarak çağrılır: AcceptChanges nesnenin DataRow yöntemi, AcceptChanges nesnenin DataTable yöntemi veya CancelEdit yöntemi.

Buna karşılık, DataRowVersion numaralandırma Current yöntemi çağrıldıktan sonra EndEdit verilerin sürümünü döndürür.

version Bağımsız değişken özelliğiyle RowState karıştırılmamalıdır. bağımsız değişkeni, version sütunun özgün değerine göre sütunun içerdiği verilerin durumunu açıklar. özelliği, RowState tüm satırın üst DataTableöğesine göre durumunu açıklar.

özelliğini ayarladığınızda, olayda ColumnChanging bir özel durum oluşursa bir özel durum oluşturulur.

Bu hemen bir düzenlemeyse, oluşturulabilecek özel durumlar için bkz EndEdit .

Item[String, DataRowVersion]

Kaynak:

DataRow.cs

Adlandırılmış sütunda depolanan verilerin belirtilen sürümünü alır.

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

Parametreler

columnName

String

Sütunun adı.

version

DataRowVersion

DataRowVersion İstediğiniz satır sürümünü belirten değerlerden biri. Olası değerler , Original, Currentve ProposeddeğerleridirDefault.

Özellik Değeri

Object

Object Verileri içeren bir.

Özel durumlar

ArgumentException

tarafından columnName belirtilen sütun bulunamıyor.

InvalidCastException

Değerin ve sütunun veri türleri eşleşmiyor.

VersionNotFoundException

Satırda bu sürümde veri yoktur.

DeletedRowInaccessibleException

Satır silindi.

Örnekler

Aşağıdaki örnek, bir denetimin tıklanan hücresinde DataGrid verilerin geçerli sürümünü alır.

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

Açıklamalar

Sürüm özelliğiyle RowState karıştırılmamalıdır. bağımsız değişkeni, version sütunun özgün değerine göre sütunun içerdiği verilerin durumunu açıklar. özelliği, RowState tüm satırın üst DataTableöğesine göre durumunu açıklar.

özelliğini ayarladığınızda, olayda ColumnChanging bir özel durum oluşursa bir özel durum oluşturulur.

Bu hemen bir düzenlemeyse, oluşturulabilecek özel durumlar için bkz EndEdit .

Ayrıca bkz.

• DataRowVersion