DataRowCollection.Contains Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

Ruft einen Wert ab, der angibt, ob die Primärschlüsselspalten der Zeilen in der Auflistung den angegebenen Wert enthalten.

Überlädt

Contains(Object)	Ruft einen Wert ab, der angibt, ob der Primärschlüssel einer Zeile in der Auflistung den angegebenen Wert enthält.
Contains(Object[])	Ruft einen Wert ab, der angibt, ob die Primärschlüsselspalten der Zeilen in der Auflistung die im Objektarray angegebenen Werte enthalten.

Contains(Object)

Ruft einen Wert ab, der angibt, ob der Primärschlüssel einer Zeile in der Auflistung den angegebenen Wert enthält.

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

public bool Contains (object? key);

public bool Contains (object key);

member this.Contains : obj -> bool

Public Function Contains (key As Object) As Boolean

Parameter

key

Object

Der Wert des Primärschlüssels, der überprüft werden soll.

Gibt zurück

Boolean

true, wenn die Auflistung eine DataRow mit dem angegebenen Primärschlüsselwert enthält, andernfalls false.

Ausnahmen

MissingPrimaryKeyException

Die Tabelle verfügt über keinen Primärschlüssel.

Beispiele

Im folgenden Visual Basic Beispiel wird die Contains Methode verwendet, um festzustellen, ob ein DataRowCollection Objekt einen bestimmten Wert enthält.

 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

Hinweise

Um die Contains Methode zu verwenden, muss das Objekt, zu dem das DataTable DataRowCollection Objekt gehört, mindestens eine Spalte als Primärschlüsselspalte festgelegt haben. Weitere Informationen zum Erstellen einer Primärschlüsselspalte finden Sie in der PrimaryKey Eigenschaft.

Sobald Sie festgestellt haben, dass eine Zeile den angegebenen Wert enthält, können Sie die Find Methode verwenden, um das bestimmte DataRow Objekt zurückzugeben, das den Wert aufweist.

Siehe auch

• PrimaryKey
• Find(Object)

Contains(Object[])

Ruft einen Wert ab, der angibt, ob die Primärschlüsselspalten der Zeilen in der Auflistung die im Objektarray angegebenen Werte enthalten.

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

public bool Contains (object?[] keys);

public bool Contains (object[] keys);

member this.Contains : obj[] -> bool

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

Parameter

keys

Object[]

Ein Array von Primärschlüsselwerten, die überprüft werden sollen.

Gibt zurück

Boolean

true, wenn die DataRowCollection eine DataRow mit den angegebenen Schlüsselwerten enthält, andernfalls false.

Ausnahmen

MissingPrimaryKeyException

Die Tabelle verfügt über keinen Primärschlüssel.

Beispiele

Im folgenden Visual Basic Beispiel wird die Contains Methode verwendet, um eine bestimmte Zeile in einem DataRowCollection Objekt zu finden. Das Beispiel erstellt ein Array von Werten, ein Element für jeden Primärschlüssel in der Tabelle und übergibt dann das Array an die Methode, um eine oder falseeine true zurückzugeben.

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

Hinweise

Um die Contains Methode mit einem Array von Werten zu verwenden, muss das Objekt, zu dem das DataRowCollection Objekt gehört, über ein Array von Spalten verfügen, die DataTable als Primärschlüssel bezeichnet werden. Weitere Informationen zum Erstellen eines Arrays von Primärschlüsselspalten finden Sie in der PrimaryKey Eigenschaft. Die Anzahl der Arrayelemente muss der Anzahl der Primärschlüsselspalten in der DataTable.

Sobald Sie festgestellt haben, dass eine Zeile den angegebenen Wert enthält, verwenden Sie die Find Methode, um das bestimmte DataRow Objekt zurückzugeben, das den Wert aufweist.

Siehe auch

• PrimaryKey
• Find(Object)