OdbcCommand クラス

定義

名前空間:

System.Data.Odbc

アセンブリ:

System.Data.Odbc.dll

パッケージ:

System.Data.Odbc v8.0.0

ソース:

OdbcCommand.cs

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

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

継承

Object

DbCommand

OdbcCommand

実装

ICloneable

例

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 、データ ソースに対してコマンドを実行するための次のメソッドが用意されています。

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

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

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

コンストラクター

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

プロパティ

CommandText	データ ソースに対して実行する SQL ステートメントまたはストアド プロシージャを取得または設定します。
CommandTimeout	コマンド実行の試行を終了してエラーを生成するまでの待機時間 (秒単位) を取得または設定します。
CommandType	CommandText プロパティをどのように解釈するかを示す値を取得または設定します。
Connection	この OdbcCommand のインスタンスで使用する OdbcConnection を取得または設定します。
DbConnection	この DbConnection により使用される DbCommand を取得または設定します。 (継承元 DbCommand)
DbParameterCollection	DbParameter オブジェクトのコレクションを取得します。 (継承元 DbCommand)
DbTransaction	この DbCommand オブジェクトが実行される DbTransaction を取得または設定します。 (継承元 DbCommand)
DesignTimeVisible	コマンド オブジェクトをカスタマイズされたインターフェイス コントロールに表示する必要があるかどうかを示す値を取得または設定します。
Parameters	OdbcParameterCollection を取得します。
Transaction	OdbcTransaction が実行される OdbcCommand を取得または設定します。
UpdatedRowSource	Update メソッドがコマンドの結果を DataRow に適用する方法を示す値を取得または設定します。

メソッド

Cancel()	OdbcCommand の実行のキャンセルを試行します。
CreateDbParameter()	DbParameter オブジェクトの新しいインスタンスを作成します。 (継承元 DbCommand)
CreateParameter()	OdbcParameter オブジェクトの新しいインスタンスを作成します。
Dispose()	アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。 (継承元 DbCommand)
Dispose(Boolean)	DbCommand によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。 (継承元 DbCommand)
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()	CommandText を Connection に送信し、OdbcDataReader を構築します。
ExecuteReader(CommandBehavior)	CommandText を Connection に送信し、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 によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 返されたタスクが完了するまで DbCommand オブジェクトの他のメソッドとプロパティを呼び出さないでください。 (継承元 DbCommand)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
Prepare()	データ ソースにコマンドの準備済みまたはコンパイル済みバージョンを作成します。
PrepareAsync(CancellationToken)	準備済み (またはコンパイル済み) バージョンのコマンドをデータ ソース上に非同期に作成します。 (継承元 DbCommand)
ResetCommandTimeout()	CommandTimeout プロパティを既定値にリセットします。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

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

ICloneable.Clone()

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

こちらもご覧ください

• OdbcDataAdapter
• OdbcConnection
• コマンドの実行