DataRowCollection.Find Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

DataRow Mendapatkan menggunakan nilai yang ditentukanPrimaryKey.

Overload

Find(Object[])	Mendapatkan baris yang berisi nilai kunci primer yang ditentukan.
Find(Object)	Mendapatkan baris yang ditentukan oleh nilai kunci primer.

Keterangan

Performa harus merupakan operasi O(log n).

Find(Object[])

Sumber:

DataRowCollection.cs

Mendapatkan baris yang berisi nilai kunci primer yang ditentukan.

public:
 System::Data::DataRow ^ Find(cli::array <System::Object ^> ^ keys);

public System.Data.DataRow? Find (object?[] keys);

member this.Find : obj[] -> System.Data.DataRow

Public Function Find (keys As Object()) As DataRow

Parameter

keys

Object[]

Array nilai kunci primer untuk ditemukan. Jenis array adalah Object.

Mengembalikan

DataRow

Objek DataRow yang berisi nilai kunci primer yang ditentukan; jika tidak, nilai null jika nilai kunci primer tidak ada di DataRowCollection.

Pengecualian

IndexOutOfRangeException

Tidak ada baris yang sesuai dengan nilai indeks tersebut.

MissingPrimaryKeyException

Tabel tidak memiliki kunci primer.

Contoh

Contoh berikut menggunakan nilai array untuk menemukan baris tertentu dalam kumpulan DataRow objek. Metode ini mengasumsikan bahwa DataTable ada dengan tiga kolom kunci primer. Setelah membuat array nilai, kode menggunakan Find metode dengan array untuk mendapatkan objek tertentu yang Anda inginkan.

private void FindInMultiPKey(DataTable table)
{
    // Create an array for the key values to find.
    object[]findTheseVals = new object[3];

    // Set the values of the keys to find.
    findTheseVals[0] = "John";
    findTheseVals[1] = "Smith";
    findTheseVals[2] = "5 Main St.";

    DataRow foundRow = table.Rows.Find(findTheseVals);
    // Display column 1 of the found row.
    if(foundRow != null)
        Console.WriteLine(foundRow[1]);
}

 Private Sub FindInMultiPKey(ByVal table As DataTable)
    ' Create an array for the key values to find.
    Dim findTheseVals(2) As Object

    ' Set the values of the keys to find.
    findTheseVals(0) = "John"
    findTheseVals(1) = "Smith"
    findTheseVals(2) = "5 Main St."

    Dim foundRow As DataRow = table.Rows.Find(findTheseVals)
    ' Display column 1 of the found row.
    If Not (foundRow Is Nothing) Then
        Console.WriteLine(foundRow(1).ToString())
    End If
End Sub

Keterangan

Untuk menggunakan metode ini Find , DataTable objek tempat objek berada harus memiliki setidaknya satu kolom yang DataRowCollection ditetapkan sebagai kolom kunci primer. Ketika dua baris atau lebih memiliki nilai kunci primer yang sama, maka baris pertama yang ditemukan dikembalikan. Ini terjadi ketika EnforceConstraints diatur ke false. PrimaryKey Lihat properti untuk informasi selengkapnya tentang cara membuat PrimaryKey kolom, atau array DataColumn objek saat tabel memiliki lebih dari satu kunci primer.

Lihat juga

• DataTable
• PrimaryKey
• Contains(Object)

Find(Object)

Sumber:

DataRowCollection.cs

Mendapatkan baris yang ditentukan oleh nilai kunci primer.

public:
 System::Data::DataRow ^ Find(System::Object ^ key);

public System.Data.DataRow? Find (object? key);

member this.Find : obj -> System.Data.DataRow

Public Function Find (key As Object) As DataRow

Parameter

key

Object

Nilai kunci primer untuk DataRow ditemukan.

Mengembalikan

DataRow

DataRow yang berisi nilai kunci primer yang ditentukan; jika tidak, nilai null jika nilai kunci primer tidak ada di DataRowCollection.

Pengecualian

MissingPrimaryKeyException

Tabel tidak memiliki kunci primer.

Contoh

Contoh berikut menggunakan Find metode untuk menemukan nilai kunci primer "2" dalam kumpulan DataRow objek. Metode mengembalikan objek tertentu DataRow yang memungkinkan Anda mengubah nilainya, sesuai kebutuhan.

private void FindInPrimaryKeyColumn(DataTable table,
    long pkValue)
{
    // Find the number pkValue in the primary key
    // column of the table.
    DataRow foundRow = table.Rows.Find(pkValue);

    // Print the value of column 1 of the found row.
    if(foundRow != null)
        Console.WriteLine(foundRow[1]);
}

 Private Sub FindInPrimaryKeyColumn(ByVal table As DataTable, _
    ByVal pkValue As Long)
    ' Find the number pkValue in the primary key 
    ' column of the table.
    Dim foundRow As DataRow = table.Rows.Find(pkValue)

    ' Print the value of column 1 of the found row.
    If Not (foundRow Is Nothing) Then
        Console.WriteLine(foundRow(1).ToString())
    End If
End Sub

Keterangan

Untuk menggunakan metode ini Find , DataTable objek tempat objek berada harus memiliki setidaknya satu kolom yang DataRowCollection ditetapkan sebagai kolom kunci primer. PrimaryKey Lihat properti untuk informasi selengkapnya tentang cara membuat kolom kunci primer.

Lihat juga

• DataTable
• PrimaryKey
• Contains(Object)