IDbCommand

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

IDbCommand インターフェイス

データ ソースに接続されている間に実行される SQL ステートメントを表します。リレーショナル データベースにアクセスする .NET Framework データ プロバイダによって実装されます。

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

Visual Basic (宣言)

Public Interface IDbCommand
    Inherits IDisposable

Visual Basic (使用法)

Dim instance As IDbCommand

C#

public interface IDbCommand : IDisposable

C++

public interface class IDbCommand : IDisposable

J#

public interface IDbCommand extends IDisposable

JScript

public interface IDbCommand extends IDisposable

解説

IDbCommand インターフェイスによって、継承クラスはデータ ソースで実行する SQL ステートメントを表す Command クラスを実装できます。Command クラスの詳細については、「コマンドの実行」を参照してください。.NET Framework データ プロバイダの実装の詳細については、「Implementing a .NET Framework Data Provider」を参照してください。

アプリケーションでは IDbCommand インターフェイスのインスタンスは直接作成されず、IDbCommand を継承するクラスのインスタンスが作成されます。

IDbCommand を継承するクラスは、すべての継承されたメンバを実装する必要があり、通常、プロバイダ固有の機能を追加する追加メンバを定義する必要があります。たとえば、IDbCommand インターフェイスが ExecuteNonQuery メソッドを定義します。次に、SqlCommand クラスがこのメソッドを継承し、ExecuteXmlReader メソッドを定義します。

実装時の注意 .NET Framework データ プロバイダ間に一貫性を持たせるために、継承クラスには PrvClassname という形式の名前を付けてください。Prv は各 .NET Framework データ プロバイダの名前空間内のすべてのクラスに付けられるプリフィックスです。たとえば、Sql は System.Data.SqlClient 名前空間内の SqlCommand クラスのプリフィックスです。 IDbCommand インターフェイスから継承する場合は、次のコンストラクタを実装する必要があります。

項目	説明
PrvCommand()	PrvCommand クラスの新しいインスタンスを初期化します。
PrvCommand(string cmdText)	クエリのテキストを使用して、PrvCommand クラスの新しいインスタンスを初期化します。
PrvCommand(string cmdText, PrvConnection connection)	クエリのテキストと PrvConnection を使用して、PrvCommand クラスの新しいインスタンスを初期化します。
PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction)	クエリのテキスト、PrvConnection、および PrvTransaction を使用して、PrvCommand クラスの新しいインスタンスを初期化します。

使用例

派生クラス SqlConnection、SqlCommand、および SqlDataReader のインスタンスを作成する例を次に示します。この例では、データを読み込み、それをコンソールに書き込みます。最後に、この例では SqlDataReader を閉じてから、SqlConnection を閉じます。

Visual Basic

Public Sub ReadOrderData(ByVal
 connectionString As String)
    Dim queryString As String
 = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New
 SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0},
 {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

C#

private static void ReadOrderData(string
 connectionString)
{
    string queryString = 
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        SqlDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
        finally
        {
            // Always call Close when done reading.
            reader.Close();
        }
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
IDbCommand メンバ
System.Data 名前空間
DbDataAdapter
IDbConnection
OleDbCommand
SqlCommand

IDbCommand プロパティ

パブリック プロパティ

	名前	説明
	UpdatedRowSource	DbDataAdapter の Update メソッドがコマンド結果を使用するときにコマンド結果を DataRow に適用する方法を取得または設定します。

参照

関連項目

IDbCommand インターフェイス
System.Data 名前空間
DbDataAdapter
IDbConnection
OleDbCommand
SqlCommand

IDbCommand メソッド

パブリック メソッド

	名前	説明
	Cancel	IDbCommand の実行をキャンセルしようとします。
	CreateParameter	IDbDataParameter オブジェクトの新しいインスタンスを作成します。
	ExecuteNonQuery	.NET Framework データ プロバイダの Connection オブジェクトに対して SQL ステートメントを実行し、影響を受けた行の数を返します。
	ExecuteReader	オーバーロードされます。 Connection に対して CommandText を実行し、IDataReader を構築します。
	ExecuteScalar	クエリを実行し、そのクエリが返す結果セットの最初の行にある最初の列を返します。余分な列または行は無視されます。
	Prepare	準備された (コンパイル済みの) バージョンのコマンドをデータ ソースに作成します。

参照

関連項目

IDbCommand インターフェイス
System.Data 名前空間
DbDataAdapter
IDbConnection
OleDbCommand
SqlCommand

IDbCommand メンバ

データ ソースに接続されている間に実行される SQL ステートメントを表します。リレーショナル データベースにアクセスする .NET Framework データ プロバイダによって実装されます。

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

パブリック プロパティ

	名前	説明
	UpdatedRowSource	DbDataAdapter の Update メソッドがコマンド結果を使用するときにコマンド結果を DataRow に適用する方法を取得または設定します。

パブリック メソッド

	名前	説明
	Cancel	IDbCommand の実行をキャンセルしようとします。
	CreateParameter	IDbDataParameter オブジェクトの新しいインスタンスを作成します。
	ExecuteNonQuery	.NET Framework データ プロバイダの Connection オブジェクトに対して SQL ステートメントを実行し、影響を受けた行の数を返します。
	ExecuteReader	オーバーロードされます。 Connection に対して CommandText を実行し、IDataReader を構築します。
	ExecuteScalar	クエリを実行し、そのクエリが返す結果セットの最初の行にある最初の列を返します。余分な列または行は無視されます。
	Prepare	準備された (コンパイル済みの) バージョンのコマンドをデータ ソースに作成します。

参照

関連項目

IDbCommand インターフェイス
System.Data 名前空間
DbDataAdapter
IDbConnection
OleDbCommand
SqlCommand