DataRow Kelas

Referensi

Definisi

Ruang nama:: System.Data

Rakitan:: System.Data.Common.dll

Rakitan:: System.Data.dll

Rakitan:: netstandard.dll

Sumber:: DataRow.cs

Sumber:: DataRow.cs

Sumber:: DataRow.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili baris data dalam DataTable.

public ref class DataRow

public class DataRow

[System.Serializable]
public class DataRow

type DataRow = class

[<System.Serializable>]
type DataRow = class

Public Class DataRow

Warisan: Object
DataRow

Atribut: SerializableAttribute

Contoh

Contoh berikut membuat baru DataRow dengan memanggil NewRow metode DataTable objek .

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

Keterangan

Objek DataRow dan DataColumn adalah komponen utama dari DataTable. DataRow Gunakan objek dan properti dan metodenya untuk mengambil dan mengevaluasi; dan menyisipkan, menghapus, dan memperbarui nilai dalam DataTable. DataRowCollection mewakili objek aktual DataRow dalam DataTable, dan DataColumnCollection berisi DataColumn objek yang menjelaskan skema DataTable. Gunakan properti yang kelebihan Item[] beban untuk mengembalikan atau mengatur nilai DataColumn.

HasVersion Gunakan properti dan IsNull untuk menentukan status nilai baris tertentu, dan RowState properti untuk menentukan status baris relatif terhadap induknyaDataTable.

Untuk membuat baru DataRow, gunakan NewRow metode DataTable objek . Setelah membuat baru DataRow, gunakan Add metode untuk menambahkan yang baru DataRow ke DataRowCollection. Terakhir, panggil AcceptChanges metode DataTable objek untuk mengonfirmasi penambahan. Untuk informasi selengkapnya tentang menambahkan data ke DataTable, lihat Menambahkan Data ke DataTable.

Anda dapat menghapus DataRow dari DataRowCollection dengan memanggil Remove metode DataRowCollection, atau dengan memanggil Delete metode DataRow objek . Metode Remove menghapus baris dari koleksi. Sebaliknya, Delete menandai DataRow untuk penghapusan. Penghapusan aktual terjadi ketika Anda memanggil AcceptChanges metode. Dengan memanggil Delete, Anda dapat secara terprogram memeriksa baris mana yang ditandai untuk dihapus sebelum benar-benar menghapusnya. Untuk informasi selengkapnya, lihat Penghapusan DataRow.

Konstruktor

DataRow(DataRowBuilder)

Menginisialisasi instans baru kelas DataRow menggunakan penyusun yang ditentukan. Hanya untuk penggunaan internal.

Properti

HasErrors	Mendapatkan nilai yang menunjukkan apakah ada kesalahan dalam satu baris.
Item[DataColumn, DataRowVersion]	Mendapatkan versi data yang ditentukan yang disimpan dalam .DataColumn
Item[DataColumn]	Mendapatkan atau mengatur data yang disimpan dalam .DataColumn
Item[Int32, DataRowVersion]	Mendapatkan data yang disimpan dalam kolom, yang ditentukan oleh indeks dan versi data yang akan diambil.
Item[Int32]	Mendapatkan atau mengatur data yang disimpan dalam kolom yang ditentukan oleh indeks.
Item[String, DataRowVersion]	Mendapatkan versi data yang ditentukan yang disimpan di kolom bernama.
Item[String]	Mendapatkan atau mengatur data yang disimpan dalam kolom yang ditentukan berdasarkan nama.
ItemArray	Mendapatkan atau mengatur semua nilai untuk baris ini melalui array.
RowError	Mendapatkan atau mengatur deskripsi kesalahan kustom untuk baris.
RowState	Mendapatkan status baris saat ini sehubungan dengan hubungannya DataRowCollectiondengan .
Table	Mendapatkan yang DataTable baris ini memiliki skema.

Metode

AcceptChanges()	Menerapkan semua perubahan yang dibuat pada baris ini sejak terakhir kali AcceptChanges() dipanggil.
BeginEdit()	Memulai operasi edit pada DataRow objek.
CancelEdit()	Membatalkan pengeditan saat ini pada baris.
ClearErrors()	Menghapus kesalahan untuk baris. Ini termasuk kesalahan dan yang RowError diatur dengan SetColumnError(Int32, String).
Delete()	DataRowMenghapus .
EndEdit()	Mengakhiri pengeditan yang terjadi pada baris.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetChildRows(DataRelation)	Mendapatkan baris anak dari ini DataRow menggunakan yang ditentukan DataRelation.
GetChildRows(DataRelation, DataRowVersion)	Mendapatkan baris anak dari DataRow menggunakan , dan DataRowVersionyang ditentukanDataRelation.
GetChildRows(String)	Mendapatkan baris anak dari DataRow menggunakan yang ditentukan RelationName dari DataRelation.
GetChildRows(String, DataRowVersion)	Mendapatkan baris anak dari DataRow menggunakan yang ditentukan RelationName dari DataRelation, dan DataRowVersion.
GetColumnError(DataColumn)	Mendapatkan deskripsi kesalahan dari yang ditentukan DataColumn.
GetColumnError(Int32)	Mendapatkan deskripsi kesalahan untuk kolom yang ditentukan oleh indeks.
GetColumnError(String)	Mendapatkan deskripsi kesalahan untuk kolom, yang ditentukan berdasarkan nama.
GetColumnsInError()	Mendapatkan array kolom yang memiliki kesalahan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetParentRow(DataRelation)	Mendapatkan baris induk dari DataRow menggunakan yang ditentukan DataRelation.
GetParentRow(DataRelation, DataRowVersion)	Mendapatkan baris induk dari DataRow menggunakan , dan DataRowVersionyang ditentukanDataRelation.
GetParentRow(String)	Mendapatkan baris induk dari DataRow menggunakan yang ditentukan RelationName dari DataRelation.
GetParentRow(String, DataRowVersion)	Mendapatkan baris induk dari DataRow menggunakan yang ditentukan RelationName dari DataRelation, dan DataRowVersion.
GetParentRows(DataRelation)	Mendapatkan baris induk dari DataRow menggunakan yang ditentukan DataRelation.
GetParentRows(DataRelation, DataRowVersion)	Mendapatkan baris induk dari DataRow menggunakan , dan DataRowVersionyang ditentukanDataRelation.
GetParentRows(String)	Mendapatkan baris induk dari DataRow menggunakan yang ditentukan RelationName dari DataRelation.
GetParentRows(String, DataRowVersion)	Mendapatkan baris induk dari DataRow menggunakan yang ditentukan RelationName dari DataRelation, dan DataRowVersion.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
HasVersion(DataRowVersion)	Mendapatkan nilai yang menunjukkan apakah ada versi tertentu.
IsNull(DataColumn)	Mendapatkan nilai yang menunjukkan apakah yang ditentukan DataColumn berisi nilai null.
IsNull(DataColumn, DataRowVersion)	Mendapatkan nilai yang menunjukkan apakah yang ditentukan DataColumn dan DataRowVersion berisi nilai null.
IsNull(Int32)	Mendapatkan nilai yang menunjukkan apakah kolom pada indeks yang ditentukan berisi nilai null.
IsNull(String)	Mendapatkan nilai yang menunjukkan apakah kolom bernama berisi nilai null.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
RejectChanges()	Menolak semua perubahan yang dibuat pada baris sejak AcceptChanges() terakhir kali dipanggil.
SetAdded()	RowState Mengubah dari menjadi DataRow`Added`.
SetColumnError(DataColumn, String)	Mengatur deskripsi kesalahan untuk kolom yang ditentukan sebagai DataColumn.
SetColumnError(Int32, String)	Mengatur deskripsi kesalahan untuk kolom yang ditentukan oleh indeks.
SetColumnError(String, String)	Mengatur deskripsi kesalahan untuk kolom yang ditentukan berdasarkan nama.
SetModified()	RowState Mengubah dari menjadi DataRow`Modified`.
SetNull(DataColumn)	Mengatur nilai yang ditentukan DataColumn ke nilai null.
SetParentRow(DataRow)	Mengatur baris induk dari dengan DataRow induk DataRowbaru yang ditentukan.
SetParentRow(DataRow, DataRelation)	Mengatur baris DataRow induk dengan induk DataRow baru yang ditentukan dan DataRelation.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Metode Ekstensi

Field<T>(DataRow, DataColumn)	Menyediakan akses yang ditik dengan kuat ke setiap nilai kolom dalam baris yang ditentukan. Metode ini Field<T>(DataRow, DataColumn) juga mendukung jenis yang dapat diubah ke null.
Field<T>(DataRow, DataColumn, DataRowVersion)	Menyediakan akses yang ditik dengan kuat ke setiap nilai kolom dalam baris yang ditentukan. Metode ini Field<T>(DataRow, DataColumn, DataRowVersion) juga mendukung jenis yang dapat diubah ke null.
Field<T>(DataRow, Int32)	Menyediakan akses yang ditik dengan kuat ke setiap nilai kolom dalam baris yang ditentukan. Metode ini Field<T>(DataRow, Int32) juga mendukung jenis yang dapat diubah ke null.
Field<T>(DataRow, Int32, DataRowVersion)	Menyediakan akses yang ditik dengan kuat ke setiap nilai kolom dalam baris yang ditentukan. Metode ini Field<T>(DataRow, Int32, DataRowVersion) juga mendukung jenis yang dapat diubah ke null.
Field<T>(DataRow, String)	Menyediakan akses yang ditik dengan kuat ke setiap nilai kolom dalam baris yang ditentukan. Metode ini Field<T>(DataRow, String) juga mendukung jenis yang dapat diubah ke null.
Field<T>(DataRow, String, DataRowVersion)	Menyediakan akses yang ditik dengan kuat ke setiap nilai kolom dalam baris yang ditentukan. Metode ini Field<T>(DataRow, String, DataRowVersion) juga mendukung jenis yang dapat diubah ke null.
SetField<T>(DataRow, DataColumn, T)	Mengatur nilai baru untuk kolom yang ditentukan di DataRow. Metode ini SetField<T>(DataRow, DataColumn, T) juga mendukung jenis yang dapat diubah ke null.
SetField<T>(DataRow, Int32, T)	Mengatur nilai baru untuk kolom yang ditentukan dalam DataRow metode dipanggil. Metode ini SetField<T>(DataRow, Int32, T) juga mendukung jenis yang dapat diubah ke null.
SetField<T>(DataRow, String, T)	Mengatur nilai baru untuk kolom yang ditentukan di DataRow. Metode ini SetField<T>(DataRow, String, T) juga mendukung jenis yang dapat diubah ke null.

Berlaku untuk

Keamanan Thread

Jenis ini aman untuk operasi baca multithreaded. Anda harus menyinkronkan operasi tulis apa pun.