OracleCommand クラス

リファレンス

定義

名前空間:: System.Data.OracleClient

アセンブリ:: System.Data.OracleClient.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

注意事項

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

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

public ref class OracleCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand

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

public sealed class OracleCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand

public sealed class OracleCommand : 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

type OracleCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable

type OracleCommand = class
    inherit DbCommand
    interface 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 Component
Implements ICloneable, IDbCommand, IDisposable

Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable

継承: Object

MarshalByRefObject

Component
OracleCommand

継承: Object

MarshalByRefObject

Component

DbCommand
OracleCommand

属性: ObsoleteAttribute

実装: IDbCommand ICloneable IDisposable

例

次の例では、テーブルからOracleCommand行をExecuteReader選択するために、メソッドと一緒OracleDataReaderに、および OracleConnection、を使用します。

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()	Component によって使用されているすべてのリソースを解放します。 (継承元 Component)
Dispose()	アンマネージリソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。 (継承元 DbCommand)
Dispose(Boolean)	Component によって使用されているアンマネージドリソースを解放し、オプションでマネージドリソースも解放します。 (継承元 Component)
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)

events

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。

(継承元 Component)

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

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

適用対象

こちらもご覧ください

コマンドの操作