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

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

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

OleDbDataAdapter.SelectCommand プロパティ

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

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

Visual Basic (宣言)

Public Property SelectCommand As
 OleDbCommand

Visual Basic (使用法)

Dim instance As OleDbDataAdapter
Dim value As OleDbCommand

value = instance.SelectCommand

instance.SelectCommand = value

public OleDbCommand SelectCommand { get; set;
 }

C++

public:
property OleDbCommand^ SelectCommand {
    OleDbCommand^ get ();
    void set (OleDbCommand^ value);
}

/** @property */
public OleDbCommand get_SelectCommand ()

/** @property */
public void set_SelectCommand (OleDbCommand
 value)

JScript

public function get SelectCommand
 () : OleDbCommand

public function set SelectCommand
 (value : OleDbCommand)

プロパティ値
Fill 処理中に、DataSet に格納するレコードをデータソースから選択するための OleDbCommand。

解説

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

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