DataRow Sınıf

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kodlar:

netstandard.dll, 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 DataRow yöntemini NewRow çağırarak yeni DataTable 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. içindeki DataRowCollection gerçek DataRow nesneleri DataTabletemsil eder ve DataColumnCollection şemasını DataColumnaçıklayan nesneleri içerirDataTable. değerini döndürmek veya ayarlamak Item[]için aşırı yüklenmiş DataColumn ö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 veri ekleme hakkında daha fazla bilgi için DataTablebkz. DataTable'a Veri Ekleme.

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

Oluşturucular

Name	Description
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

Name	Description
HasErrors	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üyle 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ın tüm değerlerini alır veya ayarlar.
RowError	Satır için özel hata açıklamasını alır veya ayarlar.
RowState	ile ilişkisiyle DataRowCollectionilgili olarak satırın geçerli durumunu alır.
Table	Bu satırın DataTable şeması olan öğesini alır.

Yöntemler

Name	Description
AcceptChanges()	Son çağrılma AcceptChanges() tarihinden bu yana bu satırda yapılan tüm değişiklikleri işler.
BeginEdit()	Nesne üzerinde DataRow düzenleme işlemi başlatır.
CancelEdit()	Satırdaki geçerli düzenlemeyi iptal eder.
ClearErrors()	Satırın 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, DataRowVersion)	Belirtilen DataRowve DataRelationkullanarak öğesinin DataRowVersion alt satırlarını alır.
GetChildRows(DataRelation)	Belirtilen DataRowkullanarak bunun DataRelation alt satırlarını alır.
GetChildRows(String, DataRowVersion)	belirtilen DataRow ve kullanarak öğesinin RelationNameDataRelationDataRowVersionalt satırlarını alır.
GetChildRows(String)	Belirtilen DataRow öğesini kullanarak öğesinin RelationName alt satırlarını DataRelationalır.
GetColumnError(DataColumn)	Belirtilen DataColumnöğesinin hata açıklamasını alır.
GetColumnError(Int32)	Dizin tarafından belirtilen sütun için hata açıklamasını alır.
GetColumnError(String)	Adla 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, DataRowVersion)	Belirtilen DataRowkullanarak bir DataRelation üst satırını alır ve DataRowVersion.
GetParentRow(DataRelation)	Belirtilen DataRowkullanarak bir DataRelation üst satırını alır.
GetParentRow(String, DataRowVersion)	bir DataRowbelirtilen RelationName kullanarak bir DataRelation üst satırını alır ve DataRowVersion.
GetParentRow(String)	bir DataRowbelirtilen RelationName kullanarak bir DataRelation üst satırını alır.
GetParentRows(DataRelation, DataRowVersion)	Belirtilen DataRowve DataRelationkullanarak bir DataRowVersion öğesinin üst satırlarını alır.
GetParentRows(DataRelation)	Belirtilen DataRowkullanarak öğesinin DataRelation üst satırlarını alır.
GetParentRows(String, DataRowVersion)	belirtilen DataRow ve kullanarak öğesinin RelationNameDataRelationDataRowVersionüst satırlarını alır.
GetParentRows(String)	Belirtilen DataRow öğesini kullanarak öğesinin RelationName üst satırlarını DataRelationalır.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
HasVersion(DataRowVersion)	Belirtilen bir sürümün var olup olmadığını gösteren bir değer alır.
IsNull(DataColumn, DataRowVersion)	Belirtilen DataColumn ve DataRowVersion null bir değer içerip içermediğini gösteren bir değer alır.
IsNull(DataColumn)	Belirtilen DataColumn değerin null değer içerip içermediğini gösteren bir değer alır.
IsNull(Int32)	Belirtilen dizindeki sütunun null değer içerip içermediğini gösteren 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 Objectbasit 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()	öğesinin RowState öğesini DataRow olarak Addeddeğ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ütun için hata açıklamasını ayarlar.
SetModified()	öğesinin RowState öğesini DataRow olarak Modifieddeğiştirir.
SetNull(DataColumn)	Belirtilen DataColumn değerini null değere ayarlar.
SetParentRow(DataRow, DataRelation)	Belirtilen yeni üst ve DataRowile bir DataRow öğesinin üst DataRelation satırını ayarlar.
SetParentRow(DataRow)	Belirtilen yeni üst öğeye sahip bir DataRow öğesinin üst DataRowsatırını ayarlar.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Uzantı Metotları

Name	Description
Field<T>(DataRow, DataColumn, DataRowVersion)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak türlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, DataColumn, DataRowVersion) atanabilir türleri de destekler.
Field<T>(DataRow, DataColumn)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak türlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, DataColumn) atanabilir türleri de destekler.
Field<T>(DataRow, Int32, DataRowVersion)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak türlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, Int32, 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, String, DataRowVersion)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak türlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, String, DataRowVersion) atanabilir türleri de destekler.
Field<T>(DataRow, String)	Belirtilen satırdaki sütun değerlerinin her birine kesin olarak türlenmiş erişim sağlar. yöntemi null Field<T>(DataRow, String) 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. Tüm 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'da DataSet'leri kullanma