OracleCommand クラス

定義

名前空間:

System.Data.OracleClient

アセンブリ:

System.Data.OracleClient.dll

注意事項

OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

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

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

[System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommand : System.Data.Common.DbCommand, ICloneable

[<System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable

継承

Object

MarshalByRefObject

Component

DbCommand

OracleCommand

属性

ObsoleteAttribute

実装

ICloneable

例

次の例では、 メソッドOracleCommandと ExecuteReader と OracleDataReaderOracleConnectionを使用して、テーブルから行を選択します。

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT EmpNo, DeptNo FROM Scott.Emp";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString, connection);
        connection.Open();
        OracleDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetInt32(1));
            }
        }
        finally
        {
            // always call Close when done reading.
            reader.Close();
        }
    }
}

Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT EmpNo, DeptNo FROM Scott.Emp"
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString, connection)
        connection.Open()
        Dim reader As OracleDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(reader.GetInt32(0) & ", " _
                   & reader.GetInt32(1))
            End While
        Finally
            ' always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

注釈

この型は非推奨であり、今後のバージョンの.NET Frameworkで削除される予定です。 詳細については、「Oracle と ADO.NET」を参照してください。

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

Item	説明
ExecuteReader	行を返すコマンドを実行します。
ExecuteOracleNonQuery	Connection に対して SQL ステートメントを実行し、影響を受けた行数を返します。
ExecuteNonQuery	SQL INSERT、DELETE、UPDATE、SET ステートメントなどのコマンドを実行します。
ExecuteScalar	データベースから単一の値 (集計値など) を.NET Frameworkデータ型として取得します。
ExecuteOracleScalar	Oracle 固有のデータ型としてデータベースから単一の値 (集計値など) を取得します。

プロパティを CommandText リセットし、オブジェクトを OracleCommand 再利用できます。

コマンドを実行すると致命的 OracleExceptionな が発生すると、 が OracleConnection 閉じる可能性があります。 ただし、ユーザーは接続を再び開き、続行できます。

注意

他の.NET Framework データ プロバイダー (SQL Server、OLE DB、ODBC) OracleCommand の Command オブジェクトとは異なり、オブジェクトは プロパティをCommandTimeoutサポートしていません。 コマンド タイムアウトを設定しても効果はなく、返される値は常に 0 です。

コンストラクター

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

プロパティ

CanRaiseEvents	古い. コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component)
CommandText	古い. データベースに対して実行する SQL ステートメントまたはストアド プロシージャを取得または設定します。
CommandTimeout	古い. コマンド実行の試行を終了してエラーを生成するまでの待機時間 (秒単位) を取得または設定します。
CommandType	古い. CommandText プロパティの解釈方法を示す値を取得または設定します。
Connection	古い. この OracleCommand のインスタンスで使用する OracleConnection を取得または設定します。
Container	古い. IContainer を含む Component を取得します。 (継承元 Component)
DbConnection	古い. この DbConnection により使用される DbCommand を取得または設定します。 (継承元 DbCommand)
DbParameterCollection	古い. DbParameter オブジェクトのコレクションを取得します。 (継承元 DbCommand)
DbTransaction	古い. この DbCommand オブジェクトが実行される DbTransaction を取得または設定します。 (継承元 DbCommand)
DesignMode	古い. Component が現在デザイン モードかどうかを示す値を取得します。 (継承元 Component)
DesignTimeVisible	古い. カスタマイズしたインターフェイス コントロールにコマンド オブジェクトを表示する必要があるかどうかを示す値を取得または設定します。
Events	古い. Component に結び付けられているイベント ハンドラーのリストを取得します。 (継承元 Component)
Parameters	古い. OracleParameterCollection を取得します。
Site	古い. Component の ISite を取得または設定します。 (継承元 Component)
Transaction	古い. OracleTransaction が実行される OracleCommand を取得または設定します。
UpdatedRowSource	古い. Update メソッドがコマンドの結果を DataRow に適用する方法を示す値を取得または設定します。

メソッド

Cancel()	古い. OracleCommand の実行のキャンセルを試行します。
Clone()	古い. この OracleCommand オブジェクトのコピーを作成します。
CreateDbParameter()	古い. DbParameter オブジェクトの新しいインスタンスを作成します。 (継承元 DbCommand)
CreateObjRef(Type)	古い. リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
CreateParameter()	古い. OracleParameter オブジェクトの新しいインスタンスを作成します。
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)
ExecuteOracleNonQuery(OracleString)	古い. Connection に対して SQL ステートメントを実行し、影響を受けた行数を返します。
ExecuteOracleScalar()	古い. クエリを実行し、そのクエリが Oracle 固有のデータ型で返す結果セットの最初の行にある最初の列を返します。 追加の列または行は無視されます。
ExecuteReader()	古い. CommandText を Connection に送信し、OracleDataReader を構築します。
ExecuteReader(CommandBehavior)	古い. CommandText を Connection に送信し、CommandBehavior 値のいずれかを使用して OracleDataReader を構築します。
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()	古い. クエリを実行し、そのクエリから .NET データ型として返される結果セットの最初の行の最初の列を返します。 追加の列または行は無視されます。
ExecuteScalarAsync()	古い. の非同期バージョン ExecuteScalar()。 コマンドを実行し、最初に返された結果セットの最初の行の最初の列を返します。 その他の列、行、結果セットはすべて無視されます。 CancellationToken.None を使用して、ExecuteScalarAsync(CancellationToken) を呼び出します。 (継承元 DbCommand)
ExecuteScalarAsync(CancellationToken)	古い. これは ExecuteScalar() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークンを無視できます。 既定の実装は ExecuteScalar() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteScalar によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 返されたタスクが完了するまで 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)

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

IDbCommand.Connection	古い. この IDbCommand のインスタンスで使用する IDbConnection を取得または設定します。 (継承元 DbCommand)
IDbCommand.CreateParameter()	古い. IDbDataParameter オブジェクトの新しいインスタンスを作成します。 (継承元 DbCommand)
IDbCommand.ExecuteReader()	古い. Connection に対して CommandText を実行し、IDataReader をビルドします。 (継承元 DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	古い. Connection に対して CommandText を実行し、CommandBehavior の値のいずれかを使用して IDataReader をビルドします。 (継承元 DbCommand)
IDbCommand.Parameters	古い. IDataParameterCollection を取得します。 (継承元 DbCommand)
IDbCommand.Transaction	古い. この DbCommand オブジェクトが実行される DbTransaction を取得または設定します。 (継承元 DbCommand)

こちらもご覧ください

• コマンドの操作