IDbCommand IDbCommand IDbCommand IDbCommand Interface

定義

データ ソースに接続しながら実行される SQL ステートメントを表し、リレーショナル データベースにアクセスする .NET Framework データ プロバイダーにより実装されます。Represents an SQL statement that is executed while connected to a data source, and is implemented by .NET Framework data providers that access relational databases.

public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
    interface IDisposable
Public Interface IDbCommand
Implements IDisposable
派生
実装

次の例は、派生クラスのインスタンスを作成SqlConnectionSqlCommand、およびSqlDataReaderします。The following example creates instances of the derived classes, SqlConnection, SqlCommand, and SqlDataReader. 例は、コンソールに書き込むデータを読み取ります。The example reads through the data, writing it to the console. 最後に、例、 SqlDataReaderSqlConnectionします。Finally, the example closes the SqlDataReader, then the SqlConnection.

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

注釈

IDbCommandインターフェイスをデータ ソースで実行される SQL ステートメントを表すコマンド クラスを実装するために、継承したクラスを使用できます。The IDbCommand interface enables an inheriting class to implement a Command class, which represents an SQL statement that is executed at a data source. コマンド クラスの詳細については、次を参照してください。コマンドを実行するします。For more information about Command classes, see Executing a Command.

アプリケーションがのインスタンスを作成していない、IDbCommandを直接インターフェイスしますが、実装するクラスのインスタンスを作成、IDbCommandインターフェイス。An application does not create an instance of the IDbCommand interface directly, but creates an instance of a class that implements the IDbCommand interface.

実装するクラスIDbCommandすべてのメンバーを実装し、通常はプロバイダー固有の機能を追加するための追加メンバーを定義する必要があります。Classes that implement IDbCommand must implement all its members, and typically define additional members to add provider-specific functionality. たとえば、IDbCommandインターフェイスを定義、ExecuteNonQueryメソッド。For example, the IDbCommand interface defines the ExecuteNonQuery method. さらに、SqlCommandクラスは、このメソッドを継承しも定義、ExecuteXmlReaderメソッド。In turn, the SqlCommand class inherits this method, and also defines the ExecuteXmlReader method.

注意 (実装者)

フォームの継承クラスの名前を .NET Framework データ プロバイダーの間で整合性を高めるPrvClassname場所Prvは特定の .NET Framework データ プロバイダー名前空間のすべてのクラスに指定された uniform プレフィックスです。To promote consistency among .NET Framework data providers, name the inheriting class in the form PrvClassname where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. たとえば、Sqlのプレフィックスは、SqlCommandクラス、System.Data.SqlClient名前空間。For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

継承する場合、IDbCommandインターフェイスでは、次のコンス トラクターを実装する必要があります。When you inherit from the IDbCommand interface, you should implement the following constructors:

アイテムItem 説明Description
PrvCommand()PrvCommand() PrvCommand クラスの新しいインスタンスを初期化します。Initializes a new instance of the PrvCommand class.

PrvCommand(string cmdText)PrvCommand(string cmdText) クエリのテキストと共に PrvCommand クラスの新しいインスタンスを初期化します。Initializes a new instance of the PrvCommand class with the text of the query.

PrvCommand(string cmdText, PrvConnection connection)PrvCommand(string cmdText, PrvConnection connection) テキスト、クエリと、PrvConnection PrvCommand クラスの新しいインスタンスを初期化します。Initializes a new instance of the PrvCommand class with the text of the query and a PrvConnection.

PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction)PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) クエリの PrvConnection および、PrvTransaction のテキストと共に PrvCommand クラスの新しいインスタンスを初期化します。Initializes a new instance of the PrvCommand class with the text of the query, a PrvConnection, and the PrvTransaction.

プロパティ

CommandText CommandText CommandText CommandText

データ ソースに対して実行するテキスト コマンドを取得または設定します。Gets or sets the text command to run against the data source.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

コマンドを実行する試みを終了してエラーが生成されるまでの待機時間を取得または設定します。Gets or sets the wait time before terminating the attempt to execute a command and generating an error.

CommandType CommandType CommandType CommandType

CommandText プロパティをどのように解釈するかを表示または指定します。Indicates or specifies how the CommandText property is interpreted.

Connection Connection Connection Connection

この IDbCommand のインスタンスで使用する IDbConnection を取得または設定します。Gets or sets the IDbConnection used by this instance of the IDbCommand.

Parameters Parameters Parameters Parameters

IDataParameterCollection を取得します。Gets the IDataParameterCollection.

Transaction Transaction Transaction Transaction

.NET Framework データ プロバイダーの Command オブジェクトが実行されるトランザクションを取得または設定します。Gets or sets the transaction within which the Command object of a .NET Framework data provider executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

DbDataAdapterUpdate(DataSet) メソッドで使用するときに、コマンドの結果を DataRow に適用する方法を取得または設定します。Gets or sets how command results are applied to the DataRow when used by the Update(DataSet) method of a DbDataAdapter.

メソッド

Cancel() Cancel() Cancel() Cancel()

IDbCommand の実行のキャンセルを試行します。Attempts to cancels the execution of an IDbCommand.

CreateParameter() CreateParameter() CreateParameter() CreateParameter()

IDbDataParameter オブジェクトの新しいインスタンスを作成します。Creates a new instance of an IDbDataParameter object.

Dispose() Dispose() Dispose() Dispose()

アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Inherited from IDisposable)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

.NET Framework データ プロバイダーの Connection オブジェクトに対して SQL ステートメントを実行し、影響を受ける行の数を返します。Executes an SQL statement against the Connection object of a .NET Framework data provider, and returns the number of rows affected.

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

Connection に対して CommandText を実行し、IDataReader をビルドします。Executes the CommandText against the Connection and builds an IDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

Connection に対して CommandText を実行し、CommandBehavior の値のいずれかを使用して IDataReader をビルドします。Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

ExecuteScalar() ExecuteScalar() ExecuteScalar() ExecuteScalar()

クエリを実行し、そのクエリが返す結果セットの最初の行にある最初の列を返します。Executes the query, and returns the first column of the first row in the resultset returned by the query. 追加の列または行は無視されます。Extra columns or rows are ignored.

Prepare() Prepare() Prepare() Prepare()

コマンドの準備済み (またはコンパイル済み) のバージョンをデータ ソースに作成します。Creates a prepared (or compiled) version of the command on the data source.

適用対象

こちらもご覧ください