OleDbCommand クラス

リファレンス

定義

名前空間:: System.Data.OleDb

アセンブリ:: System.Data.OleDb.dll

アセンブリ:: System.Data.dll

パッケージ:: System.Data.OleDb v8.0.0

パッケージ:: System.Data.OleDb v9.0.0-rc.1.24431.7

ソース:: OleDbCommand.cs

ソース:: OleDbCommand.cs

ソース:: OleDbCommand.cs

ソース:: OleDbCommand.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

データソースに対して実行する 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

継承: Object

MarshalByRefObject

Component

DbCommand
OleDbCommand

継承: Object

MarshalByRefObject

Component
OleDbCommand

実装: IDbCommand ICloneable IDisposable

例

次の例では、OleDbDataAdapter と OleDbConnectionに沿って 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	Componentの ISite を取得または設定します。 (継承元 Component)
Transaction	OleDbCommand が実行される OleDbTransaction を取得または設定します。
UpdatedRowSource	OleDbDataAdapterの `Update` メソッドで使用する場合に、コマンドの結果を 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()	CommandText を Connection に送信し、OleDbDataReaderをビルドします。
ExecuteReader(CommandBehavior)	CommandText を Connectionに送信し、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)

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

適用対象

次の方法で共有