OleDbCommand クラス

定義

名前空間:

System.Data.OleDb

アセンブリ:

System.Data.dll

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

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable

public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

継承

Object

MarshalByRefObject

Component

DbCommand

OleDbCommand

実装

IDbCommand ICloneable IDisposable

例

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

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

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

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

コンストラクター

名前	説明
OleDbCommand()	OleDbCommand クラスの新しいインスタンスを初期化します。
OleDbCommand(String, OleDbConnection, OleDbTransaction)	クエリのテキスト、OleDbCommand、およびOleDbConnectionを使用して、Transaction クラスの新しいインスタンスを初期化します。
OleDbCommand(String, OleDbConnection)	クエリのテキストとOleDbCommandを使用して、OleDbConnection クラスの新しいインスタンスを初期化します。
OleDbCommand(String)	クエリのテキストを使用して、 OleDbCommand クラスの新しいインスタンスを初期化します。

プロパティ

名前	説明
CanRaiseEvents	コンポーネントがイベントを発生できるかどうかを示す値を取得します。 (継承元 Component)
CommandText	データ ソースで実行する SQL ステートメントまたはストアド プロシージャを取得または設定します。
CommandTimeout	コマンドの実行試行を終了してエラーを生成するまでの待機時間 (秒単位) を取得または設定します。
CommandType	CommandText プロパティの解釈方法を示す値を取得または設定します。
Connection	OleDbConnectionのこのインスタンスによって使用されるOleDbCommandを取得または設定します。
Container	IContainerを含むComponentを取得します。 (継承元 Component)
DbConnection	このDbConnectionで使用されるDbCommandを取得または設定します。 (継承元 DbCommand)
DbParameterCollection	DbParameter オブジェクトのコレクションを取得します。 (継承元 DbCommand)
DbTransaction	このDbTransaction オブジェクトが実行されるDbCommandを取得または設定します。 (継承元 DbCommand)
DesignMode	Componentが現在デザイン モードであるかどうかを示す値を取得します。 (継承元 Component)
DesignTimeVisible	カスタマイズされた Windows フォーム デザイナー コントロールにコマンド オブジェクトを表示するかどうかを示す値を取得または設定します。
Events	この Componentにアタッチされているイベント ハンドラーの一覧を取得します。 (継承元 Component)
Parameters	OleDbParameterCollection を取得します。
Site	ISiteのComponentを取得または設定します。 (継承元 Component)
Transaction	OleDbTransactionが実行されるOleDbCommandを取得または設定します。
UpdatedRowSource	DataRowの Update メソッドで使用する場合にコマンドの結果をOleDbDataAdapterに適用する方法を取得または設定します。

メソッド

名前	説明
Cancel()	OleDbCommandの実行を取り消そうとします。
Clone()	現在のインスタンスのコピーである新しい OleDbCommand オブジェクトを作成します。
CreateDbParameter()	DbParameter オブジェクトの新しいインスタンスを作成します。 (継承元 DbCommand)
CreateObjRef(Type)	リモート オブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。 (継承元 MarshalByRefObject)
CreateParameter()	OleDbParameter オブジェクトの新しいインスタンスを作成します。
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 Exception プロパティを介して伝達されます。 返された Task が完了するまで、 DbCommand オブジェクトの他のメソッドとプロパティを呼び出さないでください。 (継承元 DbCommand)
ExecuteReader()	CommandTextをConnectionに送信し、OleDbDataReaderをビルドします。
ExecuteReader(CommandBehavior)	CommandTextをConnectionに送信し、OleDbDataReader値のいずれかを使用してCommandBehaviorを構築します。
ExecuteReaderAsync()	ExecuteReaderの非同期バージョン。接続に対してコマンドを実行し、結果へのアクセスに使用できるDbDataReaderを返します。 CancellationToken.None を使用して ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) を呼び出します。 (継承元 DbCommand)
ExecuteReaderAsync(CancellationToken)	ExecuteReaderの非同期バージョン。接続に対してコマンドを実行し、結果へのアクセスに使用できるDbDataReaderを返します。 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)を呼び出します。 (継承元 DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)を呼び出します。 (継承元 DbCommand)
ExecuteReaderAsync(CommandBehavior)	ExecuteReaderの非同期バージョン。接続に対してコマンドを実行し、結果へのアクセスに使用できるDbDataReaderを返します。 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()	準備済み (またはコンパイル済み) バージョンのコマンドをデータ ソースに作成します。
ResetCommandTimeout()	CommandTimeout プロパティを既定値にリセットします。
ToString()	Stringの名前 (存在する場合) を含むComponentを返します。 このメソッドはオーバーライドしないでください。 (継承元 Component)

イベント

名前	説明
Disposed	コンポーネントが Dispose() メソッドの呼び出しによって破棄されるときに発生します。 (継承元 Component)

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

名前	説明
ICloneable.Clone()	このメンバーの説明については、 Clone()を参照してください。
IDbCommand.Connection	IDbConnectionのこのインスタンスによって使用されるIDbCommandを取得または設定します。 (継承元 DbCommand)
IDbCommand.CreateParameter()	IDbDataParameter オブジェクトの新しいインスタンスを作成します。 (継承元 DbCommand)
IDbCommand.ExecuteReader()	このメンバーの説明については、 ExecuteReader()を参照してください。
IDbCommand.ExecuteReader(CommandBehavior)	CommandTextに対してConnectionを実行し、IDataReader値のいずれかを使用してCommandBehaviorをビルドします。
IDbCommand.Parameters	IDataParameterCollection を取得します。 (継承元 DbCommand)
IDbCommand.Transaction	このDbTransaction オブジェクトが実行されるDbCommandを取得または設定します。 (継承元 DbCommand)

こちらもご覧ください

• OleDbDataAdapter
• OleDbConnection
• コマンドの操作