DataRowCollection.Contains Methode

Definitie

Naamruimte:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Hiermee wordt een waarde opgehaald die aangeeft of de primaire-sleutelkolommen van een rij in de verzameling de opgegeven waarde bevatten.

Overloads

Name Description
Contains(Object)

Hiermee wordt een waarde opgehaald die aangeeft of de primaire sleutel van een rij in de verzameling de opgegeven waarde bevat.
Contains(Object[])

Hiermee wordt een waarde opgehaald die aangeeft of de primaire-sleutelkolommen van een rij in de verzameling de waarden bevatten die zijn opgegeven in de objectmatrix.

Contains(Object)

Hiermee wordt een waarde opgehaald die aangeeft of de primaire sleutel van een rij in de verzameling de opgegeven waarde bevat.

public:
 bool Contains(System::Object ^ key);
public bool Contains(object key);
member this.Contains : obj -> bool
Public Function Contains (key As Object) As Boolean

Parameters

key
Object

De waarde van de primaire sleutel die moet worden getest.

Retouren

Boolean

true als de verzameling een DataRow met de opgegeven primaire-sleutelwaarde bevat; falseanders.

Uitzonderingen

MissingPrimaryKeyException

De tabel heeft geen primaire sleutel.

Voorbeelden

In het volgende Visual Basic voorbeeld wordt de methode Contains gebruikt om te bepalen of een DataRowCollection-object een specifieke waarde bevat.

 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

Opmerkingen

Als u de Contains methode wilt gebruiken, moet het DataTable object waartoe het DataRowCollection object behoort ten minste één kolom hebben die is aangewezen als een primaire-sleutelkolom. Zie de PrimaryKey eigenschap voor meer informatie over het maken van een primaire-sleutelkolom.

Zodra u hebt vastgesteld dat een rij de opgegeven waarde bevat, kunt u de Find methode gebruiken om het specifieke DataRow object met de waarde te retourneren.

Zie ook

Van toepassing op

Contains(Object[])

Hiermee wordt een waarde opgehaald die aangeeft of de primaire-sleutelkolommen van een rij in de verzameling de waarden bevatten die zijn opgegeven in de objectmatrix.

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

Parameters

keys
Object[]

Een matrix met primaire-sleutelwaarden waarop moet worden getest.

Retouren

Boolean

trueals de DataRowCollection bevat een DataRow met de opgegeven sleutelwaarden; anders. false

Uitzonderingen

MissingPrimaryKeyException

De tabel heeft geen primaire sleutel.

Voorbeelden

In het volgende Visual Basic voorbeeld wordt de methode Contains gebruikt om een bepaalde rij in een DataRowCollection-object te vinden. In het voorbeeld wordt een matrix met waarden gemaakt, één element voor elke primaire sleutel in de tabel en wordt de matrix vervolgens doorgegeven aan de methode om een true of 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

Opmerkingen

Als u de Contains methode wilt gebruiken met een matrix met waarden, moet het DataTable object waartoe het DataRowCollection object behoort een matrix met kolommen hebben die zijn aangewezen als primaire sleutels. Zie de PrimaryKey eigenschap voor meer informatie over het maken van een matrix met primaire-sleutelkolommen. Het aantal matrixelementen moet overeenkomen met het aantal primaire-sleutelkolommen in de DataTable.

Zodra u hebt vastgesteld dat een rij de opgegeven waarde bevat, gebruikt u de Find methode om het specifieke DataRow object met de waarde te retourneren.

Zie ook

Van toepassing op