Condividi tramite

DataRowCollection.Find Metodo

Definizione

Spazio dei nomi:
System.Data
Assembly:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Ottiene un DataRow oggetto utilizzando il valore specificato PrimaryKey .

Overload

Nome Descrizione
Find(Object[])

Ottiene la riga contenente i valori di chiave primaria specificati.
Find(Object)

Ottiene la riga specificata dal valore della chiave primaria.

Commenti

Le prestazioni devono essere un'operazione O(log n).

Find(Object[])

Origine:
DataRowCollection.cs
Origine:
DataRowCollection.cs
Origine:
DataRowCollection.cs
Origine:
DataRowCollection.cs
Origine:
DataRowCollection.cs

Ottiene la riga contenente i valori di chiave primaria specificati.

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

Parametri

keys
Object[]

Matrice di valori di chiave primaria da trovare. Il tipo della matrice è Object.

Restituisce

DataRow

Oggetto DataRow contenente i valori di chiave primaria specificati; in caso contrario, un valore Null se il valore della chiave primaria non esiste in DataRowCollection.

Eccezioni

IndexOutOfRangeException

Nessuna riga corrisponde a tale valore di indice.

MissingPrimaryKeyException

La tabella non dispone di una chiave primaria.

Esempio

Nell'esempio seguente vengono utilizzati i valori di una matrice per trovare una riga specifica in una raccolta di DataRow oggetti . Il metodo presuppone che esista un DataTable oggetto con tre colonne chiave primaria. Dopo aver creato una matrice dei valori, il codice usa il Find metodo con la matrice per ottenere l'oggetto specifico desiderato.

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

Commenti

Per utilizzare il Find metodo , l'oggetto DataTable a cui appartiene l'oggetto DataRowCollection deve avere almeno una colonna designata come colonna chiave primaria. Quando due o più righe hanno lo stesso valore di chiave primaria, viene restituita la prima riga trovata. Ciò si verifica quando EnforceConstraints è impostato su false. Vedere la PrimaryKey proprietà per altre informazioni su come creare una colonna o una PrimaryKey matrice di DataColumn oggetti quando la tabella ha più di una chiave primaria.

Vedi anche

Si applica a

Find(Object)

Origine:
DataRowCollection.cs
Origine:
DataRowCollection.cs
Origine:
DataRowCollection.cs
Origine:
DataRowCollection.cs
Origine:
DataRowCollection.cs

Ottiene la riga specificata dal valore della chiave primaria.

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

Parametri

key
Object

Valore della chiave primaria dell'oggetto DataRow da trovare.

Restituisce

DataRow

Oggetto DataRow contenente il valore della chiave primaria specificato; in caso contrario, un valore Null se il valore della chiave primaria non esiste in DataRowCollection.

Eccezioni

MissingPrimaryKeyException

La tabella non dispone di una chiave primaria.

Esempio

Nell'esempio seguente viene utilizzato il Find metodo per trovare il valore della chiave primaria "2" in una raccolta di DataRow oggetti . Il metodo restituisce l'oggetto specifico DataRow che consente di modificarne i valori in base alle esigenze.

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

Commenti

Per utilizzare il Find 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à .

Vedi anche

Si applica a