DataRowCollection.Contains Metod

Definition

Namnområde:
System.Data
Sammansättning:
System.Data.dll
Sammansättning:
netstandard.dll

Hämtar ett värde som anger om primärnyckelkolumnerna för någon rad i samlingen innehåller det angivna värdet.

Överlagringar

Name Description
Contains(Object)

Hämtar ett värde som anger om primärnyckeln för någon rad i samlingen innehåller det angivna värdet.
Contains(Object[])

Hämtar ett värde som anger om primärnyckelkolumnerna för någon rad i samlingen innehåller de värden som anges i objektmatrisen.

Contains(Object)

Hämtar ett värde som anger om primärnyckeln för någon rad i samlingen innehåller det angivna värdet.

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

Parametrar

key
Object

Värdet för den primära nyckeln som ska testas för.

Returer

Boolean

true om samlingen innehåller ett DataRow med det angivna primärnyckelvärdet, annars false.

Undantag

MissingPrimaryKeyException

Tabellen har ingen primärnyckel.

Exempel

I följande Visual Basic exempel används metoden Contains för att avgöra om ett DataRowCollection-objekt innehåller ett specifikt värde.

 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

Kommentarer

Om du vill använda Contains metoden måste objektet DataTable som DataRowCollection objektet tillhör ha minst en kolumn som har angetts som en primärnyckelkolumn. Mer information om hur du skapar en primärnyckelkolumn finns i PrimaryKey egenskapen.

Så snart du har fastställt att en rad innehåller det angivna värdet kan du använda Find metoden för att returnera det specifika DataRow objektet som har värdet.

Se även

Gäller för

Contains(Object[])

Hämtar ett värde som anger om primärnyckelkolumnerna för någon rad i samlingen innehåller de värden som anges i objektmatrisen.

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

Parametrar

keys
Object[]

En matris med primära nyckelvärden att testa för.

Returer

Boolean

true DataRowCollection om innehåller en DataRow med de angivna nyckelvärdena, annars . false

Undantag

MissingPrimaryKeyException

Tabellen har ingen primärnyckel.

Exempel

I följande Visual Basic exempel används metoden Contains för att hitta en viss rad i ett DataRowCollection-objekt. Exemplet skapar en matris med värden, ett element för varje primärnyckel i tabellen och skickar sedan matrisen till metoden för att returnera en true eller 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

Kommentarer

Om du vill använda Contains metoden med en matris med värden DataTable måste objektet som DataRowCollection objektet tillhör ha en matris med kolumner som är avsedda som primära nycklar. Mer information om hur du skapar en matris med primärnyckelkolumner finns i PrimaryKey egenskapen. Antalet matriselement måste motsvara antalet primärnyckelkolumner i DataTable.

Så snart du har fastställt att en rad innehåller det angivna värdet använder du Find metoden för att returnera det specifika DataRow objektet som har värdet.

Se även

Gäller för