DataRowCollection.Contains Metoda

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Získá hodnotu, která označuje, zda primární klíč sloupce libovolného řádku v kolekci obsahují zadanou hodnotu.

Přetížení

Contains(Object)	Získá hodnotu, která označuje, zda primární klíč libovolného řádku v kolekci obsahuje zadanou hodnotu.
Contains(Object[])	Získá hodnotu, která označuje, zda primární klíč sloupce libovolného řádku v kolekci obsahují hodnoty zadané v poli objektu.

Contains(Object)

Zdroj:

DataRowCollection.cs

Získá hodnotu, která označuje, zda primární klíč libovolného řádku v kolekci obsahuje zadanou hodnotu.

public:
 bool Contains(System::Object ^ key);

public bool Contains (object? key);

member this.Contains : obj -> bool

Public Function Contains (key As Object) As Boolean

Parametry

key

Object

Hodnota primárního klíče, pro který se má testovat.

Návraty

Boolean

true pokud kolekce obsahuje hodnotu se zadanou DataRow hodnotou primárního klíče, falsev opačném případě .

Výjimky

MissingPrimaryKeyException

Tabulka nemá primární klíč.

Příklady

Následující příklad jazyka Visual Basic používá metodu Contains k určení, zda DataRowCollection objekt obsahuje konkrétní hodnotu.

 Private Sub ColContains()
    Dim table As DataTable = CType(DataGrid1.DataSource, DataTable)
    Dim rowCollection As DataRowCollection = table.Rows
    If rowCollection.Contains(Edit1.Text) Then
       Label1.Text = "At least one row contains " & Edit1.Text 
    Else
       Label1.Text = "No row contains the value in its primary key field"
    End If
End Sub

Poznámky

Pokud chcete použít metodu ContainsDataTable , musí mít objekt, ke kterému DataRowCollection objekt patří, alespoň jeden sloupec označený jako sloupec primárního klíče. Další informace o tom, jak vytvořit sloupec primárního klíče, najdete ve PrimaryKey vlastnosti.

Jakmile zjistíte, že řádek obsahuje zadanou hodnotu, můžete použít metodu Find k vrácení konkrétního DataRow objektu, který má hodnotu.

Viz také

• PrimaryKey
• Find(Object)

Contains(Object[])

Zdroj:

DataRowCollection.cs

Získá hodnotu, která označuje, zda primární klíč sloupce libovolného řádku v kolekci obsahují hodnoty zadané v poli objektu.

public:
 bool Contains(cli::array <System::Object ^> ^ keys);

public bool Contains (object?[] keys);

member this.Contains : obj[] -> bool

Public Function Contains (keys As Object()) As Boolean

Parametry

keys

Object[]

Pole hodnot primárního klíče, pro které se má testovat.

Návraty

Boolean

true pokud obsahuje DataRowCollection hodnotu DataRow se zadanými hodnotami klíče, v opačném případě false.

Výjimky

MissingPrimaryKeyException

Tabulka nemá primární klíč.

Příklady

Následující příklad jazyka Visual Basic používá metodu Contains k vyhledání konkrétního řádku v objektu DataRowCollection . Příklad vytvoří pole hodnot, jeden prvek pro každý primární klíč v tabulce, a pak předá pole metodě, která vrátí true nebo false.

Private Sub ContainsArray()
   ' This example assumes that the DataTable object contains two
   ' DataColumn objects designated as primary keys.
   ' The table has two primary key columns.
   Dim arrKeyVals(1) As Object
   Dim table As DataTable = CType(DataGrid1.DataSource, DataTable)
   Dim rowCollection As DataRowCollection = table.Rows
   arrKeyVals(0) = "Hello"
   arrKeyVals(1) = "World"
   label1.Text = rowCollection.Contains(arrKeyVals).ToString()
End Sub

Poznámky

Pokud chcete použít metodu Contains s polem hodnot, musí mít objekt, DataTable do kterého DataRowCollection objekt patří, pole sloupců označené jako primární klíče. Další informace o tom, jak vytvořit pole sloupců primárního klíče, najdete ve PrimaryKey vlastnosti. Počet prvků matice musí odpovídat počtu sloupců primárního klíče v DataTable.

Jakmile zjistíte, že řádek obsahuje zadanou hodnotu, použijte metodu Find k vrácení konkrétního DataRow objektu, který má hodnotu.

Viz také

• PrimaryKey
• Find(Object)