DataRowCollection.Find Метод

Определение

Получает DataRow с использованием указанного значения PrimaryKey.Gets a DataRow using the specified PrimaryKey value.

Перегрузки

Find(Object[])

Возвращает строку, которая содержит указанные значения первичного ключа.Gets the row that contains the specified primary key values.

Find(Object)

Возвращает строку, указанную значением первичного ключа.Gets the row specified by the primary key value.

Комментарии

Производительность должна быть операцией O (log n).Performance should be an O(log n) operation.

Find(Object[])

Возвращает строку, которая содержит указанные значения первичного ключа.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);
public System.Data.DataRow Find (object[] keys);
member this.Find : obj[] -> System.Data.DataRow
Public Function Find (keys As Object()) As DataRow

Параметры

keys
Object[]

Массив значений первичного ключа для поиска.An array of primary key values to find. Тип массива — Object.The type of the array is Object.

Возвращаемое значение

DataRow

Объект DataRow, содержащий указанные значения первичного ключа; в противном случае — значение NULL, если значение первичного ключа отсутствует в 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.

Исключения

Этому значению индекса не соответствуют никакие строки.No row corresponds to that index value.

Таблица не имеет первичного ключа.The table does not have a primary key.

Примеры

В следующем примере значения массива используются для поиска определенной строки в коллекции DataRow объектов.The following example uses the values of an array to find a specific row in a collection of DataRow objects. Метод предполагает, что DataTable существует с тремя ключевыми столбцами первичного ключа.The method assumes that a DataTable exists with three primary key columns. После создания массива значений код использует Find метод с массивом, чтобы получить нужный объект.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

Комментарии

Чтобы использовать Find метод, объект, DataTable DataRowCollection которому принадлежит объект, должен иметь хотя бы один столбец, обозначенный как первичный ключевой столбец.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. Если две или более строк имеют одинаковое значение первичного ключа, возвращается первая найденная строка.When two or more rows have the same primary key value, then the first row found is returned. Это происходит, когда EnforceConstraints имеет значение false.This occurs when EnforceConstraints is set to false. PrimaryKeyДополнительные сведения о том, как создать PrimaryKey столбец или массив DataColumn объектов, если таблица содержит более одного первичного ключа, см. в свойстве.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.

См. также раздел

Применяется к

Find(Object)

Возвращает строку, указанную значением первичного ключа.Gets the row specified by the primary key value.

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

Параметры

key
Object

Значение первичного ключа DataRow для поиска.The primary key value of the DataRow to find.

Возвращаемое значение

DataRow

Объект DataRow, содержащий указанное значение первичного ключа; в противном случае — значение NULL, если значение первичного ключа не существует в 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.

Исключения

Таблица не имеет первичного ключа.The table does not have a primary key.

Примеры

В следующем примере метод используется Find для поиска значения первичного ключа «2» в коллекции DataRow объектов.The following example uses the Find method to find the primary key value "2" in a collection of DataRow objects. Метод возвращает конкретный DataRow объект, позволяющий изменять его значения по мере необходимости.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

Комментарии

Чтобы использовать Find метод, объект, DataTable DataRowCollection которому принадлежит объект, должен иметь хотя бы один столбец, обозначенный как первичный ключевой столбец.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. PrimaryKeyДополнительные сведения о создании первичного ключевого столбца см. в описании свойства.See the PrimaryKey property for more information about how to create a primary key column.

См. также раздел

Применяется к