DataRowCollection.Find Méthode

  • Référence

Définition

Espace de noms:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Obtient un DataRow à l’aide de la valeur PrimaryKey.

Surcharges

Find(Object[])

Obtient la ligne qui contient les valeurs de clés primaires spécifiées.
Find(Object)

Obtient la ligne spécifiée par la valeur de clé primaire.

Remarques

Les performances doivent être une opération O(log n).

Find(Object[])

Source:
DataRowCollection.cs
Source:
DataRowCollection.cs
Source:
DataRowCollection.cs

Obtient la ligne qui contient les valeurs de clés primaires spécifiées.

public:
 System::Data::DataRow ^ Find(cli::array <System::Object ^> ^ keys);
public System.Data.DataRow? Find (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. Le tableau est de type Object.

Retours

DataRow

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.

Exceptions

IndexOutOfRangeException

Aucune ligne ne correspond à cette valeur d'index.

MissingPrimaryKeyException

La table ne possède pas de clé primaire.

Exemples

L’exemple suivant utilise les valeurs d’un tableau pour rechercher une ligne spécifique dans une collection d’objets DataRow . La méthode suppose qu’un DataTable existe avec trois colonnes de clé primaire. Après avoir créé un tableau des valeurs, le code utilise la Find méthode avec le tableau pour obtenir l’objet particulier souhaité.

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’objet DataTable auquel appartient l’objet DataRowCollection doit avoir au moins une colonne désignée comme colonne de clé primaire. Lorsque deux lignes ou plus ont la même valeur de clé primaire, la première ligne trouvée est retournée. Cela se produit lorsque EnforceConstraints est défini sur false. Consultez la PrimaryKey propriété pour plus d’informations sur la création d’une PrimaryKey colonne ou d’un tableau d’objets DataColumn lorsque la table a plusieurs clés primaires.

Voir aussi

S’applique à

Find(Object)

Source:
DataRowCollection.cs
Source:
DataRowCollection.cs
Source:
DataRowCollection.cs

Obtient la ligne spécifiée par la valeur de clé primaire.

public:
 System::Data::DataRow ^ Find(System::Object ^ key);
public System.Data.DataRow? Find (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.

Retours

DataRow

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.

Exceptions

MissingPrimaryKeyException

La table ne possède pas de clé primaire.

Exemples

L’exemple suivant utilise la Find méthode pour rechercher la valeur de clé primaire « 2 » dans une collection d’objets DataRow . La méthode retourne l’objet spécifique DataRow , ce qui vous permet de modifier ses valeurs, si nécessaire.

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’objet DataTable auquel appartient l’objet DataRowCollection doit avoir au moins une colonne désignée comme colonne de clé primaire. Pour plus d’informations sur la création d’une colonne de clé primaire, consultez la PrimaryKey propriété .

Voir aussi

S’applique à