DataRowCollection.Contains Metodo

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Ottiene un valore che indica se nelle colonne di chiavi primarie di qualsiasi riga dell'insieme è presente il valore specificato.

Overload

Contains(Object)	Ottiene un valore che indica se nella chiave primaria di qualsiasi riga dell'insieme è presente il valore specificato.
Contains(Object[])	Ottiene un valore che indica se nelle colonne di chiavi primarie di qualsiasi riga dell'insieme sono presenti i valori specificati nella matrice di oggetti.

Contains(Object)

Origine:

DataRowCollection.cs

Ottiene un valore che indica se nella chiave primaria di qualsiasi riga dell'insieme è presente il valore specificato.

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

public bool Contains (object? key);

member this.Contains : obj -> bool

Public Function Contains (key As Object) As Boolean

Parametri

key

Object

Valore della chiave primaria da verificare.

Restituisce

Boolean

true se nell'insieme è presente un oggetto DataRow con il valore della chiave primaria specificato; in caso contrario, false.

Eccezioni

MissingPrimaryKeyException

La tabella non dispone di una chiave primaria.

Esempio

Nell'esempio di Visual Basic seguente viene utilizzato il Contains metodo per determinare se un DataRowCollection oggetto contiene un valore specifico.

 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

Commenti

Per utilizzare il Contains metodo , l'oggetto DataTable a cui appartiene l'oggetto DataRowCollection deve avere almeno una colonna designata come colonna chiave primaria. Per altre informazioni su come creare una colonna chiave primaria, vedere la PrimaryKey proprietà .

Non appena è stato determinato che una riga contiene il valore specificato, è possibile utilizzare il Find metodo per restituire l'oggetto specifico DataRow con il valore .

Vedi anche

• PrimaryKey
• Find(Object)

Contains(Object[])

Origine:

DataRowCollection.cs

Ottiene un valore che indica se nelle colonne di chiavi primarie di qualsiasi riga dell'insieme sono presenti i valori specificati nella matrice di oggetti.

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

Parametri

keys

Object[]

Matrice di valori di chiave primaria da verificare.

Restituisce

Boolean

true se nell'insieme DataRowCollection è presente un oggetto DataRow con i valori della chiave specificati; in caso contrario, false.

Eccezioni

MissingPrimaryKeyException

La tabella non dispone di una chiave primaria.

Esempio

Nell'esempio di Visual Basic seguente viene utilizzato il Contains metodo per trovare una riga specifica in un DataRowCollection oggetto . L'esempio crea una matrice di valori, un elemento per ogni chiave primaria nella tabella e quindi passa la matrice al metodo per restituire un true oggetto o 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

Commenti

Per utilizzare il Contains metodo con una matrice di valori, l'oggetto DataTable a cui appartiene l'oggetto DataRowCollection deve avere una matrice di colonne designata come chiavi primarie. Per altre informazioni su come creare una matrice di colonne chiave primaria, vedere la PrimaryKey proprietà . Il numero di elementi della matrice deve corrispondere al numero di colonne chiave primaria in DataTable.

Non appena è stato determinato che una riga contiene il valore specificato, utilizzare il Find metodo per restituire l'oggetto specifico DataRow con il valore .

Vedi anche

• PrimaryKey
• Find(Object)