OleDbCommand クラス

定義

データ ソースに対して実行する SQL ステートメントまたはストアド プロシージャを表します。

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable
type OleDbCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
継承
OleDbCommand
継承
継承
実装

次の例では、 と と OleDbDataAdapterOleDbConnectionOleDbCommand使用して、Access データベースから行を選択します。 その後、塗りつぶし DataSet が返されます。 この例では、初期化 DataSetされた 、接続文字列、SQL SELECT ステートメントであるクエリ文字列、およびソース データベース テーブルの名前である文字列が渡されます。

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}
Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

注釈

OleDbCommand インスタンスが作成されると、読み取り/書き込みプロパティは初期値に設定されます。 これらの値の一覧については、 コンストラクターを OleDbCommand 参照してください。

OleDbCommand は、データ ソースでコマンドを実行する次のメソッドを備えています。

Item 説明
ExecuteReader 行を返すコマンドを実行します。 ExecuteReader SQL SET ステートメントなどのコマンドの実行に使用した場合、必要な効果がない可能性があります。
ExecuteNonQuery SQL INSERT、DELETE、UPDATE、SET ステートメントなどのコマンドを実行します。
ExecuteScalar データベースから集計値など、1 つの値を取得します。

プロパティを CommandText リセットし、オブジェクトを OleDbCommand 再利用できます。 ただし、新しいまたは前のコマンドを OleDbDataReader 実行するには、 を閉じる必要があります。

を実行OleDbCommandするメソッドによって致命的OleDbExceptionな (たとえば、重大度レベルが 20 以上のSQL Server) が生成された場合、OleDbConnection接続が閉じられる可能性があります。 ただし、ユーザーは接続を再び開き、続行できます。

コンストラクター

OleDbCommand()

OleDbCommand クラスの新しいインスタンスを初期化します。

OleDbCommand(String)

クエリ テキストを指定して、OleDbCommand クラスの新しいインスタンスを初期化します。

OleDbCommand(String, OleDbConnection)

クエリ テキストと OleDbConnection を指定して、OleDbCommand クラスの新しいインスタンスを初期化します。

OleDbCommand(String, OleDbConnection, OleDbTransaction)

クエリのテキスト、OleDbConnection、および Transaction を指定して、OleDbCommand クラスの新しいインスタンスを初期化します。

プロパティ

CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。

(継承元 Component)
CommandText

データ ソースで実行する SQL ステートメントまたはストアド プロシージャを取得または設定します。

CommandTimeout

コマンド実行の試行を終了してエラーを生成するまでの待機時間 (秒単位) を取得または設定します。

CommandType

CommandText プロパティをどのように解釈するかを示す値を取得または設定します。

Connection

この OleDbCommand のインスタンスで使用する OleDbConnection を取得または設定します。

Container

IContainer を含む Component を取得します。

(継承元 Component)
DbConnection

この DbConnection により使用される DbCommand を取得または設定します。

(継承元 DbCommand)
DbParameterCollection

DbParameter オブジェクトのコレクションを取得します。

(継承元 DbCommand)
DbTransaction

この DbCommand オブジェクトが実行される DbTransaction を取得または設定します。

(継承元 DbCommand)
DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。

(継承元 Component)
DesignTimeVisible

コマンド オブジェクトをカスタム Windows フォーム デザイナー コントロールに表示する必要があるかどうかを示す値を取得または設定します。

Events

Component に結び付けられているイベント ハンドラーのリストを取得します。

(継承元 Component)
Parameters

OleDbParameterCollection を取得します。

Site

ComponentISite を取得または設定します。

(継承元 Component)
Transaction

OleDbTransaction が実行される OleDbCommand を取得または設定します。

UpdatedRowSource

DataRowUpdate メソッドで使用するときに、コマンドの結果を OleDbDataAdapter に適用する方法を取得または設定します。

メソッド

Cancel()

OleDbCommand の実行のキャンセルを試行します。

Clone()

現在のインスタンスのコピーである新しい OleDbCommand オブジェクトを作成します。

CreateDbParameter()

DbParameter オブジェクトの新しいインスタンスを作成します。

(継承元 DbCommand)
CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。

(継承元 MarshalByRefObject)
CreateParameter()

OleDbParameter オブジェクトの新しいインスタンスを作成します。

Dispose()

アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。

(継承元 DbCommand)
Dispose()

Component によって使用されているすべてのリソースを解放します。

(継承元 Component)
Dispose(Boolean)

DbCommand によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

(継承元 DbCommand)
Dispose(Boolean)

Component によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

(継承元 Component)
DisposeAsync()

コマンド オブジェクトを非同期に破棄します。

(継承元 DbCommand)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
ExecuteDbDataReader(CommandBehavior)

接続に対してコマンドを実行し、結果へのアクセスに使用できる を返 DbDataReader します。

(継承元 DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

プロバイダーは、ExecuteReader のオーバーロードに既定以外の実装を提供するには、このメソッドを実装する必要があります。

既定の実装は ExecuteReader() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteReader によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

このメソッドは、早期に操作をキャンセルすることを要求するために使用できるキャンセル トークンを受け取ります。 実装は、この要求を無視する場合があります。

(継承元 DbCommand)
ExecuteNonQuery()

Connection に対して SQL ステートメントを実行し、影響を受けた行数を返します。

ExecuteNonQueryAsync()

非同期バージョンの ExecuteNonQuery()。 の接続オブジェクトに対してコマンドを実行し、影響を受ける行数を返します。

CancellationToken.None を使用して、ExecuteNonQueryAsync(CancellationToken) を呼び出します。

(継承元 DbCommand)
ExecuteNonQueryAsync(CancellationToken)

これは ExecuteNonQuery() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークンを無視できます。

既定の実装は ExecuteNonQuery() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteNonQuery() によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

返されたタスクが完了するまで DbCommand オブジェクトの他のメソッドとプロパティを呼び出さないでください。

(継承元 DbCommand)
ExecuteReader()

CommandTextConnection に送信し、OleDbDataReader を構築します。

ExecuteReader(CommandBehavior)

CommandTextConnection に送信し、CommandBehavior 値のいずれかを使用して OleDbDataReader を構築します。

ExecuteReaderAsync()

非同期バージョンの ExecuteReader。 の接続に対してコマンドを実行し DbDataReader 、結果へのアクセスに使用できる を返します。

CancellationToken.None を使用して、ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) を呼び出します。

(継承元 DbCommand)
ExecuteReaderAsync(CancellationToken)

非同期バージョンの ExecuteReader。 の接続に対してコマンドを実行し DbDataReader 、結果へのアクセスに使用できる を返します。

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) を呼び出します。

(継承元 DbCommand)
ExecuteReaderAsync(CommandBehavior)

非同期バージョンの ExecuteReader。 の接続に対してコマンドを実行し DbDataReader 、結果へのアクセスに使用できる を返します。

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) を呼び出します。

(継承元 DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) を呼び出します。

(継承元 DbCommand)
ExecuteScalar()

クエリを実行し、クエリによって返される結果セットの先頭行の最初の列を返します。 その他の列または行は無視されます。

ExecuteScalarAsync()

の非同期バージョン ExecuteScalar()。 コマンドを実行し、最初に返された結果セットの最初の行の最初の列を返します。 その他の列、行、結果セットはすべて無視されます。

CancellationToken.None を使用して、ExecuteScalarAsync(CancellationToken) を呼び出します。

(継承元 DbCommand)
ExecuteScalarAsync(CancellationToken)

これは ExecuteScalar() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークンを無視できます。

既定の実装は ExecuteScalar() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteScalar によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

返されたタスクが完了するまで DbCommand オブジェクトの他のメソッドとプロパティを呼び出さないでください。

(継承元 DbCommand)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetLifetimeService()
古い.

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
InitializeLifetimeService()
古い.

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。

(継承元 MarshalByRefObject)
Prepare()

コマンドの準備済み (またはコンパイル済み) のバージョンをデータ ソースに作成します。

PrepareAsync(CancellationToken)

準備済み (またはコンパイル済み) バージョンのコマンドをデータ ソース上に非同期に作成します。

(継承元 DbCommand)
ResetCommandTimeout()

CommandTimeout プロパティを既定値にリセットします。

ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
ToString()

Component の名前 (存在する場合) を格納する String を返します。 このメソッドはオーバーライドできません。

(継承元 Component)

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。

(継承元 Component)

明示的なインターフェイスの実装

ICloneable.Clone()

このメンバーの詳細については、「Clone()」をご覧ください。

IDbCommand.Connection

この IDbCommand のインスタンスで使用する IDbConnection を取得または設定します。

(継承元 DbCommand)
IDbCommand.CreateParameter()

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

IDbDataParameter オブジェクトの新しいインスタンスを作成します。

IDbCommand.CreateParameter()

IDbDataParameter オブジェクトの新しいインスタンスを作成します。

(継承元 DbCommand)
IDbCommand.ExecuteReader()

このメンバーの詳細については、「ExecuteReader()」をご覧ください。

IDbCommand.ExecuteReader(CommandBehavior)

Connection に対して CommandText を実行し、CommandBehavior の値のいずれかを使用して IDataReader をビルドします。

IDbCommand.Parameters

IDataParameterCollection を取得します。

(継承元 DbCommand)
IDbCommand.Transaction

この DbCommand オブジェクトが実行される DbTransaction を取得または設定します。

(継承元 DbCommand)

適用対象

こちらもご覧ください