DataRowCollection.Contains Metoda

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Pobiera wartość wskazującą, czy kolumny klucza podstawowego dowolnego wiersza w kolekcji zawierają określoną wartość.

Przeciążenia

Contains(Object)	Pobiera wartość wskazującą, czy klucz podstawowy dowolnego wiersza w kolekcji zawiera określoną wartość.
Contains(Object[])	Pobiera wartość wskazującą, czy kolumny klucza podstawowego dowolnego wiersza w kolekcji zawierają wartości określone w tablicy obiektów.

Contains(Object)

Źródło:

DataRowCollection.cs

Pobiera wartość wskazującą, czy klucz podstawowy dowolnego wiersza w kolekcji zawiera określoną wartość.

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

Wartość klucza podstawowego do przetestowania.

Zwraca

Boolean

true jeśli kolekcja zawiera element DataRow z określoną wartością klucza podstawowego; w przeciwnym razie falsewartość .

Wyjątki

MissingPrimaryKeyException

Tabela nie ma klucza podstawowego.

Przykłady

W poniższym przykładzie języka Visual Basic użyto Contains metody w celu określenia, czy DataRowCollection obiekt zawiera określoną wartość.

 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

Uwagi

Aby użyć Contains metody , obiekt, do którego DataRowCollection należy obiekt, DataTable musi mieć co najmniej jedną kolumnę wyznaczoną jako kolumnę klucza podstawowego. Zobacz właściwość , PrimaryKey aby uzyskać więcej informacji na temat tworzenia kolumny klucza podstawowego.

Po ustaleniu, że wiersz zawiera określoną wartość, możesz użyć Find metody , aby zwrócić określony DataRow obiekt, który ma wartość.

Zobacz też

• PrimaryKey
• Find(Object)

Contains(Object[])

Źródło:

DataRowCollection.cs

Pobiera wartość wskazującą, czy kolumny klucza podstawowego dowolnego wiersza w kolekcji zawierają wartości określone w tablicy obiektów.

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[]

Tablica wartości klucza podstawowego do przetestowania.

Zwraca

Boolean

true jeśli element DataRowCollection zawiera element DataRow z określonymi wartościami klucza; w przeciwnym razie wartość false.

Wyjątki

MissingPrimaryKeyException

Tabela nie ma klucza podstawowego.

Przykłady

W poniższym przykładzie języka Visual Basic użyto Contains metody w celu znalezienia określonego DataRowCollection wiersza w obiekcie. W przykładzie jest tworzona tablica wartości, jeden element dla każdego klucza podstawowego w tabeli, a następnie przekazuje tablicę do metody w celu zwrócenia true wartości lub 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

Uwagi

Aby użyć Contains metody z tablicą wartości, obiekt, do którego DataRowCollection należy obiekt, DataTable musi mieć tablicę kolumn wyznaczonych jako klucze podstawowe. Zobacz właściwość , PrimaryKey aby uzyskać więcej informacji na temat tworzenia tablicy kolumn klucza podstawowego. Liczba elementów tablicy musi odpowiadać liczbie kolumn klucza podstawowego w obiekcie DataTable.

Po ustaleniu, że wiersz zawiera określoną wartość, użyj Find metody , aby zwrócić określony DataRow obiekt, który ma wartość.

Zobacz też

• PrimaryKey
• Find(Object)