DataRow Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
içindeki bir veri DataTablesatırını temsil eder.
public ref class DataRowpublic class DataRow[System.Serializable]
public class DataRowtype DataRow = class[<System.Serializable>]
type DataRow = classPublic Class DataRow- Devralma
-
DataRow
- Öznitelikler
Ö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. içindeki DataRowCollection gerçek DataRow nesneleri DataTabletemsil eder ve DataColumnCollection şemasını DataTableaçıklayan nesneleri içerirDataColumn. değerini döndürmek veya ayarlamak DataColumniçin aşırı yüklenmiş Item[] özelliğini kullanın.
Belirli bir satır değerinin HasVersion 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 NewRow DataTable yöntemini kullanın. Yeni DataRowbir oluşturduktan sonra yöntemini kullanarak Add yeni DataRow öğesini DataRowCollectionöğesine ekleyin. 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 Remove yöntemini DataRow DataRowCollectionçağırarak Delete öğesinden DataRowCollection öğesini DataRow silebilirsiniz. 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 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ı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 sonlandırır. |
| 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 DataRow DataRelationalt 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) |
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) |
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 RelationName DataRelationöğ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 DataRow DataRelationü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() | |
| 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() | |
| 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 türlenmiş 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 türlenmiş 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 türlenmiş 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 türlenmiş 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 türlenmiş 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 türlenmiş 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. |
Şunlara uygulanır
İş 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.