DataRowCollection.Contains Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.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)

Quelle:

DataRowCollection.cs

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);

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 mithilfe der Contains -Methode ermittelt, 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 DataTable Objekt, zu dem das DataRowCollection Objekt gehört, mindestens eine Spalte als Primärschlüsselspalte festgelegt sein. 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 enthält.

Weitere Informationen

• PrimaryKey
• Find(Object)

Contains(Object[])

Quelle:

DataRowCollection.cs

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);

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 das Array dann an die -Methode, um ein true oder falsezurü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 DataTable Objekt, zu dem das DataRowCollection Objekt gehört, über ein Array von Spalten verfügen, das als Primärschlüssel festgelegt ist. PrimaryKey Weitere Informationen zum Erstellen eines Arrays von Primärschlüsselspalten finden Sie in der -Eigenschaft. Die Anzahl der Arrayelemente muss der Anzahl der Primärschlüsselspalten im DataTableentsprechen.

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

Weitere Informationen

• PrimaryKey
• Find(Object)