DataRowCollection.Contains Methode

Definition

Ruft einen Wert ab, der angibt, ob die Primärschlüsselspalten der Zeilen in der Auflistung den angegebenen Wert enthalten.Gets a value that indicates whether the primary key columns of any row in the collection contain the specified value.

Ü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.Gets a value that indicates whether the primary key of any row in the collection contains the specified value.

Contains(Object[])

Ruft einen Wert ab, der angibt, ob die Primärschlüsselspalten der Zeilen in der Auflistung die im Objektarray angegebenen Werte enthalten.Gets a value that indicates whether the primary key columns of any row in the collection contain the values specified in the object array.

Contains(Object)

Ruft einen Wert ab, der angibt, ob der Primärschlüssel einer Zeile in der Auflistung den angegebenen Wert enthält.Gets a value that indicates whether the primary key of any row in the collection contains the specified value.

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.The value of the primary key to test for.

Gibt zurück

true, wenn die Auflistung eine DataRow mit dem angegebenen Primärschlüsselwert enthält, andernfalls false.true if the collection contains a DataRow with the specified primary key value; otherwise, false.

Ausnahmen

Die Tabelle verfügt über keinen Primärschlüssel.The table does not have a primary key.

Beispiele

Im folgenden Visual Basic Beispiel wird die Contains -Methode verwendet, um DataRowCollection zu bestimmen, ob ein-Objekt einen bestimmten Wert enthält.The following Visual Basic example uses the Contains method to determine whether a DataRowCollection object contains a specific value.

 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 DataTable , muss das Objekt DataRowCollection , zu dem das Objekt gehört, mindestens eine als Primärschlüssel Spalte bezeichnete Spalte aufweisen.To use the Contains method, the DataTable object to which the DataRowCollection object belongs to must have at least one column designated as a primary key column. Weitere Informationen PrimaryKey zum Erstellen einer Primärschlüssel Spalte finden Sie unter der-Eigenschaft.See the PrimaryKey property for more information about how to create a primary key column.

Sobald Sie ermittelt haben, dass eine Zeile den angegebenen Wert enthält, können Sie die- Find Methode verwenden, um das spezifische DataRow Objekt mit dem Wert zurückzugeben.As soon as you have determined that a row contains the specified value, you can use the Find method to return the specific DataRow object that has the value.

Siehe auch

Contains(Object[])

Ruft einen Wert ab, der angibt, ob die Primärschlüsselspalten der Zeilen in der Auflistung die im Objektarray angegebenen Werte enthalten.Gets a value that indicates whether the primary key columns of any row in the collection contain the values specified in the object array.

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.An array of primary key values to test for.

Gibt zurück

true, wenn die DataRowCollection eine DataRow mit den angegebenen Schlüsselwerten enthält, andernfalls false.true if the DataRowCollection contains a DataRow with the specified key values; otherwise, false.

Ausnahmen

Die Tabelle verfügt über keinen Primärschlüssel.The table does not have a primary key.

Beispiele

Im folgenden Visual Basic Beispiel wird die Contains -Methode verwendet, um eine bestimmte Zeile DataRowCollection in einem-Objekt zu suchen.The following Visual Basic example uses the Contains method to find a particular row in a DataRowCollection object. Im Beispiel wird ein Array von-Werten erstellt, ein-Element für jeden Primärschlüssel in der Tabelle und übergibt dann das Array an die-Methode true , falseum ein oder zurückzugeben.The example creates an array of values, one element for each primary key in the table, and then passes the array to the method to return a true or 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

Hinweise

Um die Contains -Methode mit einem Array von-Werten zu DataTable verwenden, muss das DataRowCollection -Objekt, zu dem das Objekt gehört, über ein Array von als primär Schlüsseln bezeichneten Spalten verfügen.To use the Contains method with an array of values, the DataTable object to which the DataRowCollection object belongs must have an array of columns designated as primary keys. Weitere Informationen PrimaryKey zum Erstellen eines Arrays von Primärschlüssel Spalten finden Sie unter der-Eigenschaft.See the PrimaryKey property for more information about how to create an array of primary key columns. Die Anzahl von Array Elementen muss der Anzahl der Primärschlüssel Spalten in DataTableentsprechen.The number of array elements must correspond to the number of primary key columns in the DataTable.

Sobald Sie ermittelt haben, dass eine Zeile den angegebenen Wert enthält, verwenden Sie die Find -Methode, um das DataRow spezifische Objekt mit dem Wert zurückzugeben.As soon as you have determined that a row contains the specified value, use the Find method to return the specific DataRow object that has the value.

Siehe auch

Gilt für: