DataRowCollection.Contains Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Obtiene un valor que indica si las columnas de clave principal de cualquier fila de la colección contienen el valor especificado.

Sobrecargas

Contains(Object)	Obtiene un valor que indica si la clave principal de cualquier fila de la colección contiene el valor especificado.
Contains(Object[])	Obtiene un valor que indica si las columnas de clave principal de cualquier fila de la colección contienen los valores especificados en la matriz de objetos.

Contains(Object)

Source:

DataRowCollection.cs

Obtiene un valor que indica si la clave principal de cualquier fila de la colección contiene el valor especificado.

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

public bool Contains (object? key);

member this.Contains : obj -> bool

Public Function Contains (key As Object) As Boolean

Parámetros

key

Object

Valor de la clave principal que se va a comprobar.

Devoluciones

Boolean

true si la colección contiene un DataRow con el valor de clave principal especificado; de lo contrario, false.

Excepciones

MissingPrimaryKeyException

La tabla no contiene ninguna clave principal.

Ejemplos

En el siguiente ejemplo de Visual Basic se usa el Contains método para determinar si un DataRowCollection objeto contiene un valor específico.

 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

Comentarios

Para usar el Contains método , el DataTable objeto al que pertenece el DataRowCollection objeto debe tener al menos una columna designada como columna de clave principal. Consulte la PrimaryKey propiedad para obtener más información sobre cómo crear una columna de clave principal.

Tan pronto como haya determinado que una fila contiene el valor especificado, puede usar el Find método para devolver el objeto específico DataRow que tiene el valor .

Consulte también

• PrimaryKey
• Find(Object)

Contains(Object[])

Source:

DataRowCollection.cs

Obtiene un valor que indica si las columnas de clave principal de cualquier fila de la colección contienen los valores especificados en la matriz de objetos.

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

Parámetros

keys

Object[]

Matriz de valores de clave principal que se va a comprobar.

Devoluciones

Boolean

true si DataRowCollection contiene un DataRow con los valores de clave especificados; de lo contrario, false.

Excepciones

MissingPrimaryKeyException

La tabla no contiene ninguna clave principal.

Ejemplos

En el siguiente ejemplo de Visual Basic se usa el Contains método para buscar una fila determinada en un DataRowCollection objeto . En el ejemplo se crea una matriz de valores, un elemento para cada clave principal de la tabla y, a continuación, pasa la matriz al método para devolver un true 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

Comentarios

Para usar el Contains método con una matriz de valores, el DataTable objeto al que pertenece el DataRowCollection objeto debe tener una matriz de columnas designadas como claves principales. Consulte la PrimaryKey propiedad para obtener más información sobre cómo crear una matriz de columnas de clave principal. El número de elementos de matriz debe corresponder al número de columnas de clave principal de DataTable.

En cuanto haya determinado que una fila contiene el valor especificado, use el Find método para devolver el objeto específico DataRow que tiene el valor .

Consulte también

• PrimaryKey
• Find(Object)