DataRow Sınıf

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Kaynak:

DataRow.cs

içindeki bir veri DataTablesatırını temsil eder.

public ref class DataRow

public class DataRow

type DataRow = class

Public Class DataRow

Devralma

Object

DataRow

Örnekler

Aşağıdaki örnek, nesnesinin NewRow yöntemini DataTable çağırarak yeni DataRow bir oluşturur.

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

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

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

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

Açıklamalar

DataRow ve DataColumn nesneleri bir DataTableöğesinin birincil bileşenleridir. DataRow nesnesini ve özelliklerini ve yöntemlerini kullanarak alın ve değerlendirin; içindeki değerleri ekleyin, silin ve güncelleştirinDataTable. , DataRowCollection içindeki DataTablegerçek DataRow nesneleri temsil eder ve DataColumnCollection şemasını DataColumnDataTableaçıklayan nesneleri içerir. bir değerini döndürmek veya ayarlamak DataColumniçin aşırı yüklenmiş Item[] özelliğini kullanın.

HasVersion Belirli bir satır değerinin durumunu belirlemek için ve IsNull özelliklerini, RowState üst DataTablesatırın durumunu belirlemek için özelliğini kullanın.

Yeni DataRowbir oluşturmak için nesnesinin NewRowDataTable yöntemini kullanın. Yeni DataRowbir oluşturduktan sonra yöntemini kullanarak Add yeni DataRow öğesini öğesine DataRowCollectionekleyin. Son olarak, toplamayı AcceptChanges onaylamak için nesnesinin DataTable yöntemini çağırın. öğesine DataTableveri ekleme hakkında daha fazla bilgi için bkz. DataTable'a Veri Ekleme.

yöntemini çağırarak veya nesnesinin yöntemini çağırarak Delete öğesinden DataRowCollectionDataRow öğesini silebilirsinizDataRow.DataRowCollectionRemove Remove yöntemi, satırı koleksiyondan kaldırır. Buna karşılık, Delete kaldırma için işaretler DataRow . Gerçek kaldırma işlemi, yöntemini çağırdığınızda AcceptChanges gerçekleşir. çağrısı Deleteyaparak, gerçekten silmeden önce hangi satırların kaldırılmak üzere işaretleneceğini program aracılığıyla de kontrol edebilirsiniz. Daha fazla bilgi için bkz. DataRow Silme.

Oluşturucular

DataRow(DataRowBuilder)

Belirtilen oluşturucuyu kullanarak DataRow sınıfının yeni bir örneğini başlatır. Yalnızca iç kullanım için.

Özellikler

HasErrors	Bir satırda hata olup olmadığını gösteren bir değer alır.
Item[DataColumn, DataRowVersion]	Belirtilen içinde depolanan verilerin belirtilen DataColumnsürümünü alır.
Item[DataColumn]	Belirtilen DataColumniçinde depolanan verileri alır veya ayarlar.
Item[Int32, DataRowVersion]	Alınacak verilerin dizini ve sürümü tarafından belirtilen sütunda depolanan verileri alır.
Item[Int32]	Dizin tarafından belirtilen sütunda depolanan verileri alır veya ayarlar.
Item[String, DataRowVersion]	Adlandırılmış sütunda depolanan verilerin belirtilen sürümünü alır.
Item[String]	Adla belirtilen sütunda depolanan verileri alır veya ayarlar.
ItemArray	Bir dizi aracılığıyla bu satır için tüm değerleri alır veya ayarlar.
RowError	Satır için özel hata açıklamasını alır veya ayarlar.
RowState	satırın ile ilişkisiyle DataRowCollectionilgili geçerli durumunu alır.
Table	Bu satırın DataTable şeması olan öğesini alır.

Yöntemler

AcceptChanges()	Son çağrılışından AcceptChanges() bu yana bu satırda yapılan tüm değişiklikleri işler.
BeginEdit()	Nesne DataRow üzerinde düzenleme işlemi başlatır.
CancelEdit()	Satırdaki geçerli düzenlemeyi iptal eder.
ClearErrors()	Satır hatalarını temizler. Bu, RowError ile SetColumnError(Int32, String)ayarlanan ve hatalarını içerir.
Delete()	öğesini DataRowsiler.
EndEdit()	Satırda gerçekleşen düzenlemeyi sona erdirir.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetChildRows(DataRelation)	Belirtilen DataRelationkullanarak bunun DataRow alt satırlarını alır.
GetChildRows(DataRelation, DataRowVersion)	Belirtilen DataRelationve DataRowVersionkullanarak öğesinin DataRow alt satırlarını alır.
GetChildRows(String)	Belirtilen RelationName öğesini kullanarak öğesinin DataRow alt satırlarını DataRelationalır.
GetChildRows(String, DataRowVersion)	belirtilen RelationName bir ve DataRowVersionkullanarak öğesinin DataRowDataRelationalt satırlarını alır.
GetColumnError(DataColumn)	Belirtilen DataColumnöğesinin hata açıklamasını alır.
GetColumnError(Int32)	Dizin tarafından belirtilen sütunun hata açıklamasını alır.
GetColumnError(String)	Ada göre belirtilen bir sütunun hata açıklamasını alır.
GetColumnsInError()	Hataları olan bir sütun dizisi alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetParentRow(DataRelation)	Belirtilen DataRelationöğesini kullanarak bir DataRow öğesinin üst satırını alır.
GetParentRow(DataRelation, DataRowVersion)	Belirtilen DataRelationve DataRowVersionkullanarak bir DataRow öğesinin üst satırını alır.
GetParentRow(String)	Belirtilen RelationNameDataRelationöğesini kullanarak bir DataRow öğesinin üst satırını alır.
GetParentRow(String, DataRowVersion)	belirtilen RelationName ve kullanarak bir DataRow öğesinin DataRelationDataRowVersionüst satırını alır.
GetParentRows(DataRelation)	Belirtilen DataRelationkullanarak öğesinin DataRow üst satırlarını alır.
GetParentRows(DataRelation, DataRowVersion)	Belirtilen DataRelationve DataRowVersionkullanarak öğesinin DataRow üst satırlarını alır.
GetParentRows(String)	Belirtilen RelationName öğesini kullanarak öğesinin DataRow üst satırlarını DataRelationalır.
GetParentRows(String, DataRowVersion)	belirtilen RelationName bir ve DataRowVersionkullanarak öğesinin DataRowDataRelationüst satırlarını alır.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
HasVersion(DataRowVersion)	Belirtilen sürümün mevcut olup olmadığını gösteren bir değer alır.
IsNull(DataColumn)	Belirtilen DataColumn değerin null değer içerip içermediğini belirten bir değer alır.
IsNull(DataColumn, DataRowVersion)	Belirtilen DataColumn ve DataRowVersion değerinin null değer içerip içermediğini belirten bir değer alır.
IsNull(Int32)	Belirtilen dizindeki sütunun null değer içerip içermediğini belirten bir değer alır.
IsNull(String)	Adlandırılmış sütunun null değer içerip içermediğini gösteren bir değer alır.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
RejectChanges()	En son çağrıldığından bu yana AcceptChanges() satırda yapılan tüm değişiklikleri reddeder.
SetAdded()	öğesini DataRowAddedolarak RowState değiştirir.
SetColumnError(DataColumn, String)	olarak DataColumnbelirtilen bir sütun için hata açıklamasını ayarlar.
SetColumnError(Int32, String)	Dizin tarafından belirtilen bir sütun için hata açıklamasını ayarlar.
SetColumnError(String, String)	Adla belirtilen bir sütunun hata açıklamasını ayarlar.
SetModified()	öğesini DataRowModifiedolarak RowState değiştirir.
SetNull(DataColumn)	Belirtilen DataColumn değerini null değer olarak ayarlar.
SetParentRow(DataRow)	Belirtilen yeni üst öğeye sahip bir DataRow öğesinin üst DataRowsatırını ayarlar.
SetParentRow(DataRow, DataRelation)	Belirtilen yeni üst öğe ve DataRelationile bir DataRow öğesinin üst DataRow satırını ayarlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Uzantı Metotları

Field<T>(DataRow, DataColumn)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak belirlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, DataColumn) atanabilir türleri de destekler.
Field<T>(DataRow, DataColumn, DataRowVersion)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak belirlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, DataColumn, DataRowVersion) atanabilir türleri de destekler.
Field<T>(DataRow, Int32)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak belirlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, Int32) atanabilir türleri de destekler.
Field<T>(DataRow, Int32, DataRowVersion)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak belirlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, Int32, DataRowVersion) atanabilir türleri de destekler.
Field<T>(DataRow, String)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak belirlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, String) atanabilir türleri de destekler.
Field<T>(DataRow, String, DataRowVersion)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak belirlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, String, DataRowVersion) atanabilir türleri de destekler.
SetField<T>(DataRow, DataColumn, T)	içinde DataRowbelirtilen sütun için yeni bir değer ayarlar. yöntemi null SetField<T>(DataRow, DataColumn, T) atanabilir türleri de destekler.
SetField<T>(DataRow, Int32, T)	yönteminde DataRow belirtilen sütun için yeni bir değer ayarlar. yöntemi null SetField<T>(DataRow, Int32, T) atanabilir türleri de destekler.
SetField<T>(DataRow, String, T)	içinde DataRowbelirtilen sütun için yeni bir değer ayarlar. yöntemi null SetField<T>(DataRow, String, T) atanabilir türleri de destekler.

İş Parçacığı Güvenliği

Bu tür, çok iş parçacıklı okuma işlemleri için güvenlidir. Mevcut yazma işlemlerini eşitlemeniz gerekir.

Ayrıca bkz.

• AcceptChanges()
• Add(DataRow)
• DataColumnCollection
• DataColumn
• DataRowView
• DataTable
• HasVersion(DataRowVersion)
• IsNull(Int32)
• Item[Int32]
• NewRow()
• DataRowCollection
• ADO.NET'de DataSet'leri Kullanma