(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

DataRowCollection.Find-Methode (Object[])

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
Typ: System.Object[]
Ein Array von zu suchenden Primärschlüsselwerten. Der Typ des Arrays ist Object.

Rückgabewert

Typ: System.Data.DataRow
Ein DataRow-Objekt, das die angegebenen Primärschlüsselwerte enthält, andernfalls ein NULL-Wert, wenn der Primärschlüsselwert in der DataRowCollection nicht vorhanden ist.

AusnahmeBedingung
IndexOutOfRangeException

Diesem Indexwert entspricht keine Zeile.

MissingPrimaryKeyException

Die Tabelle verfügt über keinen Primärschlüssel.

Um die Find-Methode verwenden zu können, muss das DataTable-Objekt, zu dem das DataRowCollection-Objekt gehört, über mindestens eine Spalte verfügen, die als Primärschlüsselspalte festgelegt ist. Wenn zwei oder mehr Zeilen denselben Primärschlüsselwert enthalten, wird die erste gefundene Zeile zurückgegeben. Dies tritt ein, wenn EnforceConstraints auf False festgelegt ist. Unter der PrimaryKey-Eigenschaft finden Sie weitere Informationen über das Erstellen einer PrimaryKey-Spalte bzw. über das Erstellen eines Arrays von DataColumn-Objekten, wenn die Tabelle über mehrere Primärschlüssel verfügt.

Im folgenden Beispiel wird mit den Werten eines Arrays eine bestimmte Zeile in einer Auflistung von DataRow-Objekten gesucht. Die Methode geht davon aus, dass eine DataTable mit drei Primärschlüsselspalten vorhanden ist. Nach dem Erstellen eines Arrays der Werte wird im Code die Find-Methode mit dem Array verwendet, um das gewünschte 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

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2014 Microsoft