OdbcCommand

.NET Framework クラス ライブラリ リファレンス

OdbcCommand イベント

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)

参照

関連項目

OdbcCommand クラス
System.Data.Odbc 名前空間
OdbcDataAdapter
OdbcConnection

その他の技術情報

Executing a Command

OdbcCommand クラス

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

名前空間: System.Data.Odbc
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 OdbcCommand
    Inherits DbCommand
    Implements ICloneable

Visual Basic (使用法)

Dim instance As OdbcCommand

C#

public sealed class OdbcCommand : DbCommand,
 ICloneable

C++

public ref class OdbcCommand sealed : public
 DbCommand, ICloneable

J#

public final class OdbcCommand extends DbCommand
 implements ICloneable

JScript

public final class OdbcCommand extends
 DbCommand implements ICloneable

解説

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

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

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

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

使用例

OdbcCommand クラスの ExecuteReader メソッドを OdbcDataReader クラスおよび OdbcConnection クラスと共に使用して、テーブルから行を選択する例を次に示します。

Visual Basic

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

C#

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.
    }

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.Odbc.OdbcCommand

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OdbcCommand メンバ
System.Data.Odbc 名前空間
OdbcDataAdapter
OdbcConnection
その他の技術情報
Executing a Command

OdbcCommand コンストラクタ ()

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

名前空間: System.Data.Odbc
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New OdbcCommand

C#

public OdbcCommand ()

C++

public:
OdbcCommand ()

J#

public OdbcCommand ()

JScript

public function OdbcCommand ()

解説

基本コンストラクタは、すべてのフィールドを既定値に初期化します。OdbcCommand のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	初期値
CommandText	空の文字列 ("")
.Data.Odbc.OdbcCommand.CommandTimeout	30
CommandType	Text
Connection	null

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OdbcCommand クラス
OdbcCommand メンバ
System.Data.Odbc 名前空間
OdbcDataAdapter
OdbcConnection
その他の技術情報
Executing a Command
Executing a Command

OdbcCommand コンストラクタ (String)

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

名前空間: System.Data.Odbc
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    cmdText As String _
)

Visual Basic (使用法)

Dim cmdText As String

Dim instance As New OdbcCommand(cmdText)

C#

public OdbcCommand (
    string cmdText
)

C++

public:
OdbcCommand (
    String^ cmdText
)

J#

public OdbcCommand (
    String cmdText
)

JScript

public function OdbcCommand (
    cmdText : String
)

パラメータ

cmdText

クエリ テキスト。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OdbcCommand クラス
OdbcCommand メンバ
System.Data.Odbc 名前空間
その他の技術情報
Executing a Command

OdbcCommand コンストラクタ (String, OdbcConnection, OdbcTransaction)

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

名前空間: System.Data.Odbc
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    cmdText As String, _
    connection As OdbcConnection, _
    transaction As OdbcTransaction _
)

Visual Basic (使用法)

Dim cmdText As String
Dim connection As OdbcConnection
Dim transaction As OdbcTransaction

Dim instance As New OdbcCommand(cmdText,
 connection, transaction)

C#

public OdbcCommand (
    string cmdText,
    OdbcConnection connection,
    OdbcTransaction transaction
)

C++

public:
OdbcCommand (
    String^ cmdText, 
    OdbcConnection^ connection, 
    OdbcTransaction^ transaction
)

J#

public OdbcCommand (
    String cmdText, 
    OdbcConnection connection, 
    OdbcTransaction transaction
)

JScript

public function OdbcCommand (
    cmdText : String, 
    connection : OdbcConnection, 
    transaction : OdbcTransaction
)

パラメータ

cmdText

クエリ テキスト。

connection

データ ソースへの接続を表す OdbcConnection オブジェクト。

transaction

OdbcCommand を実行するトランザクション。

解説

OdbcCommand のこの実装のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	初期値
CommandText	cmdText
.Data.Odbc.OdbcCommand.CommandTimeout	30
CommandType	Text
Connection	connection パラメータの値である新しい OdbcConnection。

これらのパラメータの値は、関連するプロパティを設定することによって変更できます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OdbcCommand クラス
OdbcCommand メンバ
System.Data.Odbc 名前空間
その他の技術情報
Executing a Command

OdbcCommand コンストラクタ (String, OdbcConnection)

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

名前空間: System.Data.Odbc
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    cmdText As String, _
    connection As OdbcConnection _
)

Visual Basic (使用法)

Dim cmdText As String
Dim connection As OdbcConnection

Dim instance As New OdbcCommand(cmdText,
 connection)

C#

public OdbcCommand (
    string cmdText,
    OdbcConnection connection
)

C++

public:
OdbcCommand (
    String^ cmdText, 
    OdbcConnection^ connection
)

J#

public OdbcCommand (
    String cmdText, 
    OdbcConnection connection
)

JScript

public function OdbcCommand (
    cmdText : String, 
    connection : OdbcConnection
)

パラメータ

cmdText

クエリ テキスト。

connection

データ ソースへの接続を表す OdbcConnection オブジェクト。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OdbcCommand クラス
OdbcCommand メンバ
System.Data.Odbc 名前空間
その他の技術情報
Executing a Command

OdbcCommand コンストラクタ

OdbcCommand クラスの新しいインスタンスを初期化します。 Executing a Command
オーバーロードの一覧

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

参照

関連項目

OdbcCommand クラス
OdbcCommand メンバ
System.Data.Odbc 名前空間
OdbcDataAdapter
OdbcConnection

その他の技術情報

Executing a Command
Executing a Command

OdbcCommand プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	CommandText	オーバーライドされます。 データ ソースに対して実行する SQL ステートメントまたはストアド プロシージャを取得または設定します。
	CommandTimeout	オーバーライドされます。 コマンド実行の試行を終了し、エラーを生成するまでの待機時間を取得または設定します。
	CommandType	オーバーライドされます。 CommandText プロパティの解釈方法を示す値を取得または設定します。
	Connection	この OdbcCommand のインスタンスで使用する OdbcConnection を取得または設定します。
	Container	Component を格納している IContainer を取得します。 ( Component から継承されます。)
	DesignTimeVisible	オーバーライドされます。 コマンド オブジェクトをカスタマイズされたインターフェイス コントロールに表示する必要があるかどうかを示す値を取得または設定します。
	Parameters	OdbcParameterCollection を取得します。
	Site	Component の ISite を取得または設定します。 ( Component から継承されます。)
	Transaction	OdbcCommand を実行する OdbcTransaction を取得または設定します。
	UpdatedRowSource	オーバーライドされます。 Update メソッドがコマンドの結果を DataRow に適用する方法を示す値を取得または設定します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。)

参照

関連項目

OdbcCommand クラス
System.Data.Odbc 名前空間
OdbcDataAdapter
OdbcConnection

その他の技術情報

Executing a Command

OdbcCommand メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Cancel	オーバーライドされます。 OdbcCommand の実行のキャンセルを試行します。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	CreateParameter	OdbcParameter オブジェクトの新しいインスタンスを作成します。
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	ExecuteNonQuery	オーバーライドされます。 Connection に対して SQL ステートメントを実行し、影響を受けた行数を返します。
	ExecuteReader	オーバーロードされます。 CommandText を Connection に送信し、OdbcDataReader を構築します。
	ExecuteScalar	オーバーライドされます。 クエリを実行し、そのクエリが返す結果セットの最初の行にある最初の列を返します。残りの列または行は無視されます。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	Prepare	オーバーライドされます。 データ ソースに対する準備済みの (コンパイルされた) コマンドを作成します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ResetCommandTimeout	CommandTimeout プロパティを既定値にリセットします。
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

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

	名前	説明
	System.Data.IDbCommand.ExecuteReader	オーバーロードされます。
	System.ICloneable.Clone	このメンバの説明については、System.ICloneable.Clone. のトピックを参照してください。

参照

関連項目

OdbcCommand クラス
System.Data.Odbc 名前空間
OdbcDataAdapter
OdbcConnection

その他の技術情報

Executing a Command

OdbcCommand メンバ

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

OdbcCommand データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	OdbcCommand	オーバーロードされます。 OdbcCommand クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	CommandText	オーバーライドされます。 データ ソースに対して実行する SQL ステートメントまたはストアド プロシージャを取得または設定します。
	CommandTimeout	オーバーライドされます。 コマンド実行の試行を終了し、エラーを生成するまでの待機時間を取得または設定します。
	CommandType	オーバーライドされます。 CommandText プロパティの解釈方法を示す値を取得または設定します。
	Connection	この OdbcCommand のインスタンスで使用する OdbcConnection を取得または設定します。
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	DesignTimeVisible	オーバーライドされます。 コマンド オブジェクトをカスタマイズされたインターフェイス コントロールに表示する必要があるかどうかを示す値を取得または設定します。
	Parameters	OdbcParameterCollection を取得します。
	Site	Component の ISite を取得または設定します。(Component から継承されます。)
	Transaction	OdbcCommand を実行する OdbcTransaction を取得または設定します。
	UpdatedRowSource	オーバーライドされます。 Update メソッドがコマンドの結果を DataRow に適用する方法を示す値を取得または設定します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Cancel	オーバーライドされます。 OdbcCommand の実行のキャンセルを試行します。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	CreateParameter	OdbcParameter オブジェクトの新しいインスタンスを作成します。
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	ExecuteNonQuery	オーバーライドされます。 Connection に対して SQL ステートメントを実行し、影響を受けた行数を返します。
	ExecuteReader	オーバーロードされます。 CommandText を Connection に送信し、OdbcDataReader を構築します。
	ExecuteScalar	オーバーライドされます。 クエリを実行し、そのクエリが返す結果セットの最初の行にある最初の列を返します。残りの列または行は無視されます。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	Prepare	オーバーライドされます。 データ ソースに対する準備済みの (コンパイルされた) コマンドを作成します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ResetCommandTimeout	CommandTimeout プロパティを既定値にリセットします。
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)

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

	名前	説明
	System.Data.IDbCommand.ExecuteReader	オーバーロードされます。
	System.ICloneable.Clone	このメンバの説明については、System.ICloneable.Clone. のトピックを参照してください。

参照

関連項目

OdbcCommand クラス
System.Data.Odbc 名前空間
OdbcDataAdapter
OdbcConnection

その他の技術情報

Executing a Command