DataRowCollection.Find Méthode

Définition

Obtient un DataRow à l’aide de la valeur PrimaryKey.Gets a DataRow using the specified PrimaryKey value.

Surcharges

Find(Object[])

Obtient la ligne qui contient les valeurs de clés primaires spécifiées.Gets the row that contains the specified primary key values.

Find(Object)

Obtient la ligne spécifiée par la valeur de clé primaire.Gets the row specified by the primary key value.

Remarques

Les performances doivent être une opération O (log n).Performance should be an O(log n) operation.

Find(Object[])

Obtient la ligne qui contient les valeurs de clés primaires spécifiées.Gets the row that contains the specified primary key values.

public:
 System::Data::DataRow ^ Find(cli::array <System::Object ^> ^ keys);
public System.Data.DataRow Find (object[] keys);
member this.Find : obj[] -> System.Data.DataRow
Public Function Find (keys As Object()) As DataRow

Paramètres

keys
Object[]

Tableau de valeurs de clés primaires à rechercher.An array of primary key values to find. Le tableau est de type Object.The type of the array is Object.

Retours

Objet DataRow qui contient les valeurs de clés primaires spécifiées ; sinon, la valeur null si la valeur de clé primaire n'existe pas dans DataRowCollection.A DataRow object that contains the primary key values specified; otherwise a null value if the primary key value does not exist in the DataRowCollection.

Exceptions

Aucune ligne ne correspond à cette valeur d'index.No row corresponds to that index value.

La table ne possède pas de clé primaire.The table does not have a primary key.

Exemples

L’exemple suivant utilise les valeurs d’un tableau pour rechercher une ligne spécifique dans une collection d' DataRow objets.The following example uses the values of an array to find a specific row in a collection of DataRow objects. La méthode suppose qu’un DataTable existe avec trois colonnes clés primaires.The method assumes that a DataTable exists with three primary key columns. Après avoir créé un tableau des valeurs, le code utilise la Find méthode avec le tableau pour obtenir l’objet particulier souhaité.After creating an array of the values, the code uses the Find method with the array to get the particular object that you want.

private void FindInMultiPKey(DataTable table)
{
    // Create an array for the key values to find.
    object[]findTheseVals = new object[3];

    // Set the values of the keys to find.
    findTheseVals[0] = "John";
    findTheseVals[1] = "Smith";
    findTheseVals[2] = "5 Main St.";

    DataRow foundRow = table.Rows.Find(findTheseVals);
    // Display column 1 of the found row.
    if(foundRow != null)
        Console.WriteLine(foundRow[1]);
}
 Private Sub FindInMultiPKey(ByVal table As DataTable)
    ' Create an array for the key values to find.
    Dim findTheseVals(2) As Object

    ' Set the values of the keys to find.
    findTheseVals(0) = "John"
    findTheseVals(1) = "Smith"
    findTheseVals(2) = "5 Main St."

    Dim foundRow As DataRow = table.Rows.Find(findTheseVals)
    ' Display column 1 of the found row.
    If Not (foundRow Is Nothing) Then
        Console.WriteLine(foundRow(1).ToString())
    End If
End Sub

Remarques

Pour utiliser la Find méthode, l' DataTable objet auquel appartient l' DataRowCollection objet doit avoir au moins une colonne désignée comme colonne de clé primaire.To use the Find method, the DataTable object to which the DataRowCollection object belongs must have at least one column designated as a primary key column. Si au moins deux lignes ont la même valeur de clé primaire, la première ligne trouvée est retournée.When two or more rows have the same primary key value, then the first row found is returned. Cela se produit EnforceConstraints lorsque a la valeur false.This occurs when EnforceConstraints is set to false. Pour plus PrimaryKey d’informations sur la création d’une PrimaryKey colonne ou d’un tableau d' DataColumn objets lorsque la table possède plusieurs clés primaires, consultez la propriété.See the PrimaryKey property for more information about how to create a PrimaryKey column, or an array of DataColumn objects when the table has more than one primary key.

Voir aussi

Find(Object)

Obtient la ligne spécifiée par la valeur de clé primaire.Gets the row specified by the primary key value.

public:
 System::Data::DataRow ^ Find(System::Object ^ key);
public System.Data.DataRow Find (object key);
member this.Find : obj -> System.Data.DataRow
Public Function Find (key As Object) As DataRow

Paramètres

key
Object

Valeur de clé primaire du DataRow à rechercher.The primary key value of the DataRow to find.

Retours

DataRow qui contient la valeur de clé primaire spécifiée, ou une valeur null si la valeur de clé primaire n'existe pas dans le DataRowCollection.A DataRow that contains the primary key value specified; otherwise a null value if the primary key value does not exist in the DataRowCollection.

Exceptions

La table ne possède pas de clé primaire.The table does not have a primary key.

Exemples

L’exemple suivant utilise la Find méthode pour rechercher la valeur de clé primaire « 2 » dans une collection DataRow d’objets.The following example uses the Find method to find the primary key value "2" in a collection of DataRow objects. La méthode retourne l’objet DataRow spécifique qui vous permet de modifier ses valeurs, si nécessaire.The method returns the specific DataRow object letting you change its values, as needed.

private void FindInPrimaryKeyColumn(DataTable table, 
    long pkValue)
{
    // Find the number pkValue in the primary key 
    // column of the table.
    DataRow foundRow = table.Rows.Find(pkValue);

    // Print the value of column 1 of the found row.
    if(foundRow != null)
        Console.WriteLine(foundRow[1]);
}
 Private Sub FindInPrimaryKeyColumn(ByVal table As DataTable, _
    ByVal pkValue As Long)
    ' Find the number pkValue in the primary key 
    ' column of the table.
    Dim foundRow As DataRow = table.Rows.Find(pkValue)

    ' Print the value of column 1 of the found row.
    If Not (foundRow Is Nothing) Then
        Console.WriteLine(foundRow(1).ToString())
    End If
End Sub

Remarques

Pour utiliser la Find méthode, l' DataTable objet auquel appartient l' DataRowCollection objet doit avoir au moins une colonne désignée comme colonne de clé primaire.To use the Find method, the DataTable object to which the DataRowCollection object belongs must have at least one column designated as a primary key column. Pour plus PrimaryKey d’informations sur la création d’une colonne de clé primaire, consultez la propriété.See the PrimaryKey property for more information about how to create a primary key column.

Voir aussi

S’applique à