OleDbCommand クラス

定義

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

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 ref class OleDbCommand sealed : 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
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
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, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
継承
継承
実装

次の例では、OleDbDataAdapterOleDbConnectionに沿って OleDbCommandを使用して、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 には、データ ソースでコマンドを実行する次のメソッドがあります。

アイテム 形容
ExecuteReader 行を返すコマンドを実行します。 ExecuteReader は、SQL SET ステートメントなどのコマンドの実行に使用する場合に必要な効果がない可能性があります。
ExecuteNonQuery SQL INSERT、DELETE、UPDATE、SET ステートメントなどのコマンドを実行します。
ExecuteScalar 1 つの値 (たとえば、データベースから集計値) を取得します。

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

OleDbCommandを実行するメソッドによって致命的な OleDbException (たとえば、SQL Server の重大度レベル 20 以上) が生成された場合、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

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

(継承元 Component)
DbConnection

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

(継承元 DbCommand)
DbParameterCollection

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

(継承元 DbCommand)
DbTransaction

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

(継承元 DbCommand)
DesignMode

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

(継承元 Component)
DesignTimeVisible

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

Events

この Componentにアタッチされているイベント ハンドラーの一覧を取得します。

(継承元 Component)
Parameters

OleDbParameterCollectionを取得します。

Site

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

(継承元 Component)
Transaction

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

UpdatedRowSource

OleDbDataAdapterUpdate メソッドで使用する場合に、コマンドの結果を DataRow に適用する方法を取得または設定します。

メソッド

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 によってスローされた例外は、返されたタスク例外プロパティを介して伝達されます。

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

(継承元 DbCommand)
ExecuteNonQuery()

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

ExecuteNonQueryAsync()

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

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

(継承元 DbCommand)
ExecuteNonQueryAsync(CancellationToken)

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

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

返された Task が完了するまで、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 によってスローされた例外は、返されたタスク例外プロパティを介して伝達されます。

返された Task が完了するまで、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()

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)

拡張メソッド

ConfigureAwait(IAsyncDisposable, Boolean)

非同期破棄から返されるタスクの待機を実行する方法を構成します。

適用対象

こちらもご覧ください