DataRowCollection.Find DataRowCollection.Find DataRowCollection.Find DataRowCollection.Find Method

定義

指定した PrimaryKey 値を使って DataRow を取得します。Gets a DataRow using the specified PrimaryKey value.

オーバーロード

Find(Object[]) Find(Object[]) Find(Object[]) Find(Object[])

指定した主キー値が格納されている行を取得します。Gets the row that contains the specified primary key values.

Find(Object) Find(Object) Find(Object) Find(Object)

主キー値で指定した行を取得します。Gets the row specified by the primary key value.

注釈

パフォーマンスは、O (log n) 操作である必要があります。Performance should be an O(log n) operation.

Find(Object[]) Find(Object[]) Find(Object[]) 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);
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 オブジェクト。指定した主キー値が DataRowCollection 内に存在しない場合は null 値。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 3 つの主キー列が存在することを前提としています。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

注釈

メソッドを使用DataRowCollectionするには、オブジェクトが属するオブジェクトに、少なくとも1つの列が主キー列として指定されている必要があります。DataTable FindTo 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. 2つ以上の行が同じ主キー値を持っている場合は、最初に見つかった行が返されます。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. 列を作成する方法の詳細については、 DataColumn プロパティを参照してください。テーブルに複数の主キーがある場合は、オブジェクトの配列を参照してください。PrimaryKey PrimaryKeySee 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) Find(Object) Find(Object) 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);
member this.Find : obj -> System.Data.DataRow
Public Function Find (key As Object) As DataRow

パラメーター

key
Object Object Object Object

検索する DataRow の主キー値。The primary key value of the DataRow to find.

戻り値

指定した主キー値が格納されている DataRow。指定した主キー値が DataRowCollection 内に存在しない場合は null 値。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 、メソッドを使用して、オブジェクトのDataRowコレクション内の主キーの値 "2" を検索します。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

注釈

メソッドを使用DataRowCollectionするには、オブジェクトが属するオブジェクトに、少なくとも1つの列が主キー列として指定されている必要があります。DataTable FindTo 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.

こちらもご覧ください

適用対象