DataRow Sınıf

Tanım

İçindeki bir veri satırını temsil eder DataTable .Represents a row of data in a DataTable.

public ref class DataRow
public class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
[<System.Serializable>]
type DataRow = class
Public Class DataRow
Devralma
DataRow
Öznitelikler

Örnekler

Aşağıdaki örnek, DataRow nesnesinin yöntemini çağırarak yeni bir oluşturur NewRow DataTable .The following example creates a new DataRow by calling the NewRow method of the DataTable object.

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

DataRowVe nesneleri, ' DataColumn nin birincil bileşenleridir DataTable .The DataRow and DataColumn objects are primary components of a DataTable. DataRowNesnesini ve özelliklerini ve yöntemlerini ve öğesini alıp değerlendirmek için kullanın; ve içindeki değerleri ekleyin, silin ve güncelleştirin DataTable .Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. , DataRowCollection İçindeki gerçek nesneleri temsil eder DataRow DataTable ve DataColumnCollection DataColumn öğesinin şemasını tanımlayan nesneleri içerir DataTable .The DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. ' Item[] Nin değerini döndürmek veya ayarlamak için aşırı yüklenmiş özelliğini kullanın DataColumn .Use the overloaded Item[] property to return or set the value of a DataColumn.

HasVersion IsNull Belirli bir satır değerinin durumunu ve RowState üst öğesine göre satırın durumunu belirleyecek özelliği öğrenmek için ve özelliklerini kullanın DataTable .Use the HasVersion and IsNull properties to determine the status of a particular row value, and the RowState property to determine the state of the row relative to its parent DataTable.

Yeni bir oluşturmak için DataRow NewRow nesnesinin yöntemini kullanın DataTable .To create a new DataRow, use the NewRow method of the DataTable object. Yeni bir oluşturduktan sonra, DataRow ' Add ye yeni eklemek için yöntemini kullanın DataRow DataRowCollection .After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Son olarak, AcceptChanges DataTable eklemeyi onaylamak için nesnesinin yöntemini çağırın.Finally, call the AcceptChanges method of the DataTable object to confirm the addition. Uygulamasına veri ekleme hakkında daha fazla bilgi için DataTable bkz. DataTable 'A veri ekleme.For more information about adding data to a DataTable, see Adding Data to a DataTable.

DataRowİçinden DataRowCollection Remove ' a yöntemini çağırarak DataRowCollection veya Delete nesnesinin metodunu çağırarak DataRow öğesinden silebilirsiniz.You can delete a DataRow from the DataRowCollection by calling the Remove method of the DataRowCollection, or by calling the Delete method of the DataRow object. RemoveYöntemi, sırayı koleksiyondan kaldırır.The Remove method removes the row from the collection. Buna karşılık, Delete DataRow kaldırma için işaretini işaretler.In contrast, Delete marks the DataRow for removal. Metodu çağırdığınızda gerçek kaldırma gerçekleşir AcceptChanges .The actual removal occurs when you call AcceptChanges method. Delete' İ çağırarak, gerçekten silinmeden önce hangi satırların kaldırılması için işaretlendiğini programlı bir şekilde denetleyebilirsiniz.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. Daha fazla bilgi için bkz. DataRow silme.For more information, see DataRow Deletion.

Oluşturucular

DataRow(DataRowBuilder)

DataRow öğesinin yeni bir örneğini başlatır.Initializes a new instance of the DataRow. Oluşturucu 'dan bir satır oluşturur.Constructs a row from the builder. Yalnızca iç kullanım için.Only for internal usage.

Özellikler

HasErrors

Bir satırda hata olup olmadığını gösteren bir değer alır.Gets a value that indicates whether there are errors in a row.

Item[DataColumn, DataRowVersion]

Belirtilen verilerin belirtilen sürümünü belirtilen şekilde alır DataColumn .Gets the specified version of data stored in the specified DataColumn.

Item[DataColumn]

Belirtilen ' de depolanan verileri alır veya ayarlar DataColumn .Gets or sets the data stored in the specified DataColumn.

Item[Int32, DataRowVersion]

Alınacak verilerin dizini ve sürümü ile belirtilen sütununda depolanan verileri alır.Gets the data stored in the column, specified by index and version of the data to retrieve.

Item[Int32]

Dizin tarafından belirtilen sütunda depolanan verileri alır veya ayarlar.Gets or sets the data stored in the column specified by index.

Item[String, DataRowVersion]

Adlandırılmış sütunda depolanan verilerin belirtilen sürümünü alır.Gets the specified version of data stored in the named column.

Item[String]

Ada göre belirtilen sütunda depolanan verileri alır veya ayarlar.Gets or sets the data stored in the column specified by name.

ItemArray

Bu satırın tüm değerlerini bir dizi aracılığıyla alır veya ayarlar.Gets or sets all the values for this row through an array.

RowError

Bir satır için özel hata açıklamasını alır veya ayarlar.Gets or sets the custom error description for a row.

RowState

İle ilişkisine göre satırın geçerli durumunu alır DataRowCollection .Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table

DataTableBu satırın bir şemaya sahip olduğu öğesini alır.Gets the DataTable for which this row has a schema.

Yöntemler

AcceptChanges()

Son kez çağrılmasından bu yana bu satıra yapılan tüm değişiklikleri kaydeder AcceptChanges() .Commits all the changes made to this row since the last time AcceptChanges() was called.

BeginEdit()

Bir nesne üzerinde düzenleme işlemi başlatır DataRow .Starts an edit operation on a DataRow object.

CancelEdit()

Satırdaki geçerli düzenlemeyi iptal eder.Cancels the current edit on the row.

ClearErrors()

Satır için hataları temizler.Clears the errors for the row. Bu, RowError ile ayarlanan ve hataları içerir SetColumnError(Int32, String) .This includes the RowError and errors set with SetColumnError(Int32, String).

Delete()

Öğesini siler DataRow .Deletes the DataRow.

EndEdit()

Satırdaki gerçekleşen düzenlemeyi sonlandırır.Ends the edit occurring on the row.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetChildRows(DataRelation)

Belirtilen ' i kullanarak bunun alt satırlarını alır DataRow DataRelation .Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion)

Öğesinin alt satırlarını, DataRow DataRelation ve ' ı kullanarak alır DataRowVersion .Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String)

Öğesinin bir öğesini kullanarak öğesinin alt satırlarını alır DataRow RelationName DataRelation .Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(String, DataRowVersion)

DataRow RelationName DataRelation , Ve ' yi kullanarak bir öğesinin alt satırlarını alır DataRowVersion .Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetColumnError(DataColumn)

Belirtilen hata açıklamasını alır DataColumn .Gets the error description of the specified DataColumn.

GetColumnError(Int32)

Dizin tarafından belirtilen sütun için hata açıklamasını alır.Gets the error description for the column specified by index.

GetColumnError(String)

Ada göre belirtilen bir sütunun hata açıklamasını alır.Gets the error description for a column, specified by name.

GetColumnsInError()

Hataları olan bir sütun dizisini alır.Gets an array of columns that have errors.

GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetParentRow(DataRelation)

Belirtilen öğesini kullanarak bir öğesinin üst satırını alır DataRow DataRelation .Gets the parent row of a DataRow using the specified DataRelation.

GetParentRow(DataRelation, DataRowVersion)

Bir öğesinin üst satırını, DataRow ve öğesini kullanarak alır DataRelation DataRowVersion .Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRow(String)

DataRowBelirtilen öğesinin bir öğesini kullanarak öğesinin üst satırını alır RelationName DataRelation .Gets the parent row of a DataRow using the specified RelationName of a DataRelation.

GetParentRow(String, DataRowVersion)

DataRow RelationName DataRelation , Ve ' nin belirtilen öğesini kullanarak bir öğesinin üst satırını alır DataRowVersion .Gets the parent row of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetParentRows(DataRelation)

Belirtilen öğesini kullanarak bir öğesinin üst satırını alır DataRow DataRelation .Gets the parent rows of a DataRow using the specified DataRelation.

GetParentRows(DataRelation, DataRowVersion)

DataRow DataRelation , Ve ' yi kullanarak bir öğesinin üst satırını alır DataRowVersion .Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String)

Bir öğesinin öğesini kullanarak bir öğesinin üst satırını alır DataRow RelationName DataRelation .Gets the parent rows of a DataRow using the specified RelationName of a DataRelation.

GetParentRows(String, DataRowVersion)

DataRow RelationName DataRelation , Ve ' yi kullanarak bir öğesinin üst satırını alır DataRowVersion .Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
HasVersion(DataRowVersion)

Belirtilen bir sürümün var olup olmadığını gösteren bir değer alır.Gets a value that indicates whether a specified version exists.

IsNull(DataColumn)

Belirtilen değerin DataColumn null bir değer içerip içermediğini gösteren bir değer alır.Gets a value that indicates whether the specified DataColumn contains a null value.

IsNull(DataColumn, DataRowVersion)

Belirtilen DataColumn ve DataRowVersion null bir değer içerip içermediğini gösteren bir değer alır.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

IsNull(Int32)

Belirtilen dizindeki sütunun null değer içerip içermediğini gösteren bir değer alır.Gets a value that indicates whether the column at the specified index contains a null value.

IsNull(String)

Adlandırılmış sütunun null değer içerip içermediğini gösteren bir değer alır.Gets a value that indicates whether the named column contains a null value.

MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
RejectChanges()

Son çağrılmasından bu yana satırda yapılan tüm değişiklikleri reddeder AcceptChanges() .Rejects all changes made to the row since AcceptChanges() was last called.

SetAdded()

' RowState A ' a değişir DataRow Added .Changes the RowState of a DataRow to Added.

SetColumnError(DataColumn, String)

Olarak belirtilen bir sütunun hata açıklamasını ayarlar DataColumn .Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

Dizin tarafından belirtilen bir sütunun hata açıklamasını ayarlar.Sets the error description for a column specified by index.

SetColumnError(String, String)

Ada göre belirtilen bir sütunun hata açıklamasını ayarlar.Sets the error description for a column specified by name.

SetModified()

' RowState A ' a değişir DataRow Modified .Changes the RowState of a DataRow to Modified.

SetNull(DataColumn)

Belirtilen değerini DataColumn null bir değer olarak ayarlar.Sets the value of the specified DataColumn to a null value.

SetParentRow(DataRow)

Belirtilen yeni üst öğesiyle bir öğesinin üst satırını ayarlar DataRow DataRow .Sets the parent row of a DataRow with specified new parent DataRow.

SetParentRow(DataRow, DataRelation)

Bir öğesinin üst satırını, DataRow belirtilen yeni üst öğesi ve ile ayarlar DataRow DataRelation .Sets the parent row of a DataRow with specified new parent DataRow and DataRelation.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Uzantı Metotları

Field<T>(DataRow, DataColumn)

Belirtilen satırdaki sütun değerlerinin her birine kesin olarak yazılmış erişim sağlar.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn)Yöntemi null yapılabilir türleri de destekler.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion)

Belirtilen satırdaki sütun değerlerinin her birine kesin olarak yazılmış erişim sağlar.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn, DataRowVersion)Yöntemi null yapılabilir türleri de destekler.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32)

Belirtilen satırdaki sütun değerlerinin her birine kesin olarak yazılmış erişim sağlar.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32)Yöntemi null yapılabilir türleri de destekler.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion)

Belirtilen satırdaki sütun değerlerinin her birine kesin olarak yazılmış erişim sağlar.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32, DataRowVersion)Yöntemi null yapılabilir türleri de destekler.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String)

Belirtilen satırdaki sütun değerlerinin her birine kesin olarak yazılmış erişim sağlar.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String)Yöntemi null yapılabilir türleri de destekler.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion)

Belirtilen satırdaki sütun değerlerinin her birine kesin olarak yazılmış erişim sağlar.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String, DataRowVersion)Yöntemi null yapılabilir türleri de destekler.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

SetField<T>(DataRow, DataColumn, T)

İçinde belirtilen sütun için yeni bir değer ayarlar DataRow .Sets a new value for the specified column in the DataRow. SetField<T>(DataRow, DataColumn, T)Yöntemi null yapılabilir türleri de destekler.The SetField<T>(DataRow, DataColumn, T) method also supports nullable types.

SetField<T>(DataRow, Int32, T)

Yönteminde belirtilen sütun için yeni bir değer ayarlar DataRow .Sets a new value for the specified column in the DataRow the method is called on. SetField<T>(DataRow, Int32, T)Yöntemi null yapılabilir türleri de destekler.The SetField<T>(DataRow, Int32, T) method also supports nullable types.

SetField<T>(DataRow, String, T)

İçinde belirtilen sütun için yeni bir değer ayarlar DataRow .Sets a new value for the specified column in the DataRow. SetField<T>(DataRow, String, T)Yöntemi null yapılabilir türleri de destekler.The SetField<T>(DataRow, String, T) method also supports nullable types.

Şunlara uygulanır

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

Bu tür, çok iş parçacıklı okuma işlemleri için güvenlidir.This type is safe for multithreaded read operations. Mevcut yazma işlemlerini eşitlemeniz gerekir.You must synchronize any write operations.

Ayrıca bkz.