Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DataRowCollection.Find-Methode: (Object[])

 

Veröffentlicht: Juli 2016

Ruft die Zeile mit den angegebenen Primärschlüsselwerten ab.

Namespace:   System.Data
Assembly:  System.Data (in System.Data.dll)

public DataRow Find(
	object[] keys
)

Parameter

keys
Type: System.Object[]

Ein Array von Primärschlüsselwerten gefunden. Der Typ des Arrays ist Object.

Rückgabewert

Type: System.Data.DataRow

Ein DataRow angegebene Objekt, das die Primärschlüsselwerte enthält; andernfalls eine Null-Wert, wenn der Primärschlüsselwert in nicht vorhanden ist die DataRowCollection.

Exception Condition
IndexOutOfRangeException

Keine Zeile entspricht dieser Indexwert.

MissingPrimaryKeyException

Die Tabelle keinen Primärschlüssel.

Verwenden der Find -Methode, die DataTable Objekt, mit dem die DataRowCollection Objekt gehört, muss mindestens eine Spalte als Primärschlüsselspalte festgelegt haben. Wenn zwei oder mehr Zeilen den gleichen Primärschlüsselwert aufweisen, wird die erste gefundene Zeile zurückgegeben. Dies tritt auf, wenn EnforceConstraints auf "false" festgelegt ist. Finden Sie unter der PrimaryKey -Eigenschaft für Weitere Informationen zum Erstellen einer PrimaryKey Spalte oder ein Array von DataColumn Objekte, wenn die Tabelle mehr als einen primären Schlüssel aufweist.

Im folgenden Beispiel wird die Werte eines Arrays zu einer bestimmten Zeile in einer Auflistung von DataRow Objekte. Die Methode setzt voraus, dass ein DataTable mit drei Primärschlüsselspalten vorhanden ist. Nach dem Erstellen ein Array mit den Werten, die der Code verwendet die Find Methode mit dem Array auf das betreffende Objekt abzurufen.

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]);
}

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: