IDbDataAdapter.SelectCommand プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IDbDataAdapter.SelectCommand プロパティ

データソース内のレコードを選択する SQL ステートメントを取得または設定します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Property SelectCommand As IDbCommand

Visual Basic (使用法)

Dim instance As IDbDataAdapter
Dim value As IDbCommand

value = instance.SelectCommand

instance.SelectCommand = value

IDbCommand SelectCommand { get; set; }

C++

property IDbCommand^ SelectCommand {
    IDbCommand^ get ();
    void set (IDbCommand^ value);
}

/** @property */
IDbCommand get_SelectCommand ()

/** @property */
void set_SelectCommand (IDbCommand value)

JScript

function get SelectCommand () : IDbCommand

function set SelectCommand (value : IDbCommand)

プロパティ値
データセットに挿入するレコードをデータソースから選択するために、Update 中に使用する IDbCommand。

解説

作成済みの IDbCommand に SelectCommand が割り当てられた場合、IDbCommand のクローンは作成されません。SelectCommand によって、作成済みの IDbCommand オブジェクトへの参照が維持されます。

SelectCommand が行を返さなかった場合は、DataSet にテーブルは追加されず、例外は生成されません。

使用例

継承した OleDbDataAdapter クラスのインスタンスを作成し、SelectCommand プロパティと InsertCommand プロパティを設定する例を次に示します。ここでは、OleDbConnection オブジェクトが既に作成されていることを前提にしています。

Visual Basic

Public Shared Function CreateCustomerAdapter(
 _
    connection As OleDbConnection) As OleDbDataAdapter
 

    Dim adapter As OleDbDataAdapter = New
 OleDbDataAdapter()
    Dim command As OleDbCommand

    ' Create the SelectCommand.
    command = New OleDbCommand("SELECT * FROM
 Customers " & _
        "WHERE Country = ? AND City = ?", connection)

    command.Parameters.Add("Country", OleDbType.VarChar,
 15)
    command.Parameters.Add("City", OleDbType.VarChar,
 15)

    adapter.SelectCommand = command

    ' Create the InsertCommand.
    command = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) "
 & _
        "VALUES (?, ?)", connection)

    command.Parameters.Add( _
        "CustomerID", OleDbType.Char, 5, "CustomerID")
    command.Parameters.Add( _
        "CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.InsertCommand = command
    Return adapter
End Function

public static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter();
    OleDbCommand command;

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT * FROM Customers "
 +
        "WHERE Country = ? AND City = ?", connection);

    command.Parameters.Add("Country", OleDbType.VarChar, 15);
    command.Parameters.Add("City", OleDbType.VarChar, 15);

    adapter.SelectCommand = command;

    // Create the InsertCommand.
    command = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)", connection);

    command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    command.Parameters.Add(
        "CompanyName", OleDbType.VarChar, 40, "CompanyName");

    adapter.InsertCommand = command;
    return adapter;
}