OdbcCommand クラス

定義

データ ソースに対して実行する SQL ステートメントまたはストアド プロシージャを表します。 このクラスは継承できません。

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

次の例では、ExecuteNonQueryを使用します。

public void InsertRow(string connectionString, string insertSQL)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OdbcCommand command = new OdbcCommand(insertSQL, connection);

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OdbcConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OdbcCommand(insertSQL, connection)

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

注釈

OdbcCommand クラスには、データ ソースに対してコマンドを実行するための次のメソッドが用意されています。

アイテム 形容
ExecuteReader 行を返すコマンドを実行します。
ExecuteNonQuery SQL INSERT、DELETE、UPDATE、SET ステートメントなどのコマンドを実行します。
ExecuteScalar 1 つの値 (集計値など) をデータベースから取得します。

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

コマンドを実行すると、SQL Server の重大度レベルが 20 以上などの致命的な OdbcException が発生した場合、OdbcConnection が閉じる可能性があります。 ただし、ユーザーは接続を再度開いて続行できます。

コンストラクター

OdbcCommand()

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

OdbcCommand(String)

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

OdbcCommand(String, OdbcConnection)

クエリのテキストと OdbcConnection オブジェクトを使用して、OdbcCommand クラスの新しいインスタンスを初期化します。

OdbcCommand(String, OdbcConnection, OdbcTransaction)

クエリのテキスト、OdbcConnection オブジェクト、および Transactionを使用して、OdbcCommand クラスの新しいインスタンスを初期化します。

プロパティ

CanRaiseEvents

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

(継承元 Component)
CommandText

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

CommandTimeout

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

CommandType

CommandText プロパティの解釈方法を示す値を取得または設定します。

Connection

OdbcCommandのこのインスタンスによって使用される OdbcConnection を取得または設定します。

Container

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

(継承元 Component)
DbConnection

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

(継承元 DbCommand)
DbParameterCollection

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

(継承元 DbCommand)
DbTransaction

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

(継承元 DbCommand)
DesignMode

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

(継承元 Component)
DesignTimeVisible

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

Events

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

(継承元 Component)
Parameters

OdbcParameterCollectionを取得します。

Site

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

(継承元 Component)
Transaction

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

UpdatedRowSource

Update メソッドがコマンド結果を DataRowに適用する方法を指定する値を取得または設定します。

メソッド

Cancel()

OdbcCommandの実行を取り消そうとします。

CreateDbParameter()

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

(継承元 DbCommand)
CreateObjRef(Type)

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

(継承元 MarshalByRefObject)
CreateParameter()

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

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 に送信し、OdbcDataReaderをビルドします。

ExecuteReader(CommandBehavior)

CommandTextConnectionに送信し、CommandBehavior 値のいずれかを使用して OdbcDataReader を作成します。

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()

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

IDbCommand.CreateParameter()

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

(継承元 DbCommand)
IDbCommand.ExecuteReader()

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

Connection に対して CommandText を実行し、IDataReaderをビルドします。

IDbCommand.ExecuteReader()

Connection に対して CommandText を実行し、IDataReaderをビルドします。

(継承元 DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

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

Connectionに対して CommandText を実行し、指定した動作を使用して IDataReader をビルドします。

IDbCommand.ExecuteReader(CommandBehavior)

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

(継承元 DbCommand)
IDbCommand.Parameters

IDataParameterCollectionを取得します。

(継承元 DbCommand)
IDbCommand.Transaction

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

(継承元 DbCommand)

拡張メソッド

ConfigureAwait(IAsyncDisposable, Boolean)

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

適用対象

こちらもご覧ください