OracleConnection クラス

定義

名前空間:

System.Data.OracleClient

アセンブリ:

System.Data.OracleClient.dll

注意事項

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

データベースへの開いた接続を表します。 このクラスは継承できません。

public ref class OracleConnection sealed : System::Data::Common::DbConnection, ICloneable

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

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

Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable

継承

Object

MarshalByRefObject

Component

DbConnection

OracleConnection

属性

ObsoleteAttribute

実装

ICloneable

例

次の例では、 と を OracleCommand 作成します OracleConnection。 OracleConnectionが開き、 プロパティとして設定されますOracleCommand.Connection。 次に、 を呼び出 ExecuteNonQueryし、接続を閉じます。 これを実現するために、 ExecuteNonQuery には接続文字列と SQL INSERT ステートメントであるクエリ文字列が渡されます。

public void InsertRow(string connectionString)
{
    string queryString =
        "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString);
        command.Connection = connection;
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

Public Sub InsertRow(ByVal connectionString As String)
    Dim queryString As String = _
      "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')"

    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString)
        command.Connection = connection
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Using
End Sub

注釈

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

オブジェクトは OracleConnection 、Oracle データベースへの一意の接続を表します。 クライアント/サーバー データベース システムの場合、サーバーへのネットワーク接続と同じです。

オブジェクトの OracleConnection インスタンスを作成するアプリケーションでは、直接および間接のすべての呼び出し元がコードに対する適切なアクセス許可を持つ必要がある宣言型または命令型のセキュリティ要求を設定できます。 OracleConnection は、 オブジェクトを使用してセキュリティ要求を OraclePermission 作成します。 ユーザーは、 オブジェクトを使用 OraclePermissionAttribute して、コードに適切なアクセス許可があることを確認できます。 ユーザーと管理者は、コード アクセス セキュリティ ポリシー ツール (Caspol.exe) を使用して、コンピューター、ユーザー、およびエンタープライズ レベルでセキュリティ ポリシーを変更することもできます。 詳細については、セキュリティに関するページをご覧ください。

注意

他の.NET Framework データ プロバイダー (SQL Server、OLE DB、ODBC) OracleConnection の Connection オブジェクトとは異なり、 プロパティはサポートConnectionTimeoutされていません。 接続タイムアウトをプロパティまたは接続文字列に設定しても効果はなく、返される値は常に 0 です。 OracleConnectionでは、プロパティまたはメソッドもChangeDatabaseサポートDatabaseされていません。

オブジェクトが OracleConnection スコープ外になった場合、オブジェクトは開いたままです。 したがって、 または Dispose を呼び出Closeすか、 ステートメント内で オブジェクトを使用して、常にオブジェクトをOracleConnectionUsing閉じるOracleConnection必要があります。 そうしないと、ガベージ コレクションによってすぐに解放されない可能性があります。 このような遅延は、多数の接続がガベージ コレクターによって削除されるのを待機している間に接続の最大数に達した場合にエラーが発生する可能性があります。 これに対し、 を呼び出 Close して接続を閉じると、ネイティブ リソースがより効率的に使用され、スケーラビリティが向上し、アプリケーションの全体的なパフォーマンスが向上します。 接続が常に閉じられるようにするには、ブロック内の接続を Using 開きます。

注意

高パフォーマンスのアプリケーションをデプロイするには、多くの場合、接続プールを使用する必要があります。 ただし、.NET Framework Data Provider for Oracle を使用する場合、プロバイダーはこれを自動的に管理するため、接続プールを有効にする必要はありません。

コンストラクター

OracleConnection()	古い. OracleConnectionの新しいインスタンスを初期化します。
OracleConnection(String)	古い. 接続文字列を指定して、OracleConnection クラスの新しいインスタンスを初期化します。

プロパティ

CanCreateBatch	古い. この DbConnection インスタンスが DbBatch クラスをサポートしているかどうかを示す値を取得します。 (継承元 DbConnection)
CanRaiseEvents	古い. コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component)
ConnectionString	古い. Oracle データベースを開くために使用する文字列を取得または設定します。
ConnectionTimeout	古い. 試行を中断してエラーを生成する前に、接続の確立時に待機する時間を取得します。
Container	古い. IContainer を含む Component を取得します。 (継承元 Component)
Database	古い. 現在のデータベース、または接続が開いてから使用するデータベースの名前を取得します。
DataSource	古い. 接続する Oracle サーバーの名前を取得します。
DbProviderFactory	古い. この DbProviderFactory の DbConnection を取得します。 (継承元 DbConnection)
DesignMode	古い. Component が現在デザイン モードかどうかを示す値を取得します。 (継承元 Component)
Events	古い. Component に結び付けられているイベント ハンドラーのリストを取得します。 (継承元 Component)
ServerVersion	古い. クライアントが接続しているサーバーのバージョンが示された文字列を取得します。
Site	古い. Component の ISite を取得または設定します。 (継承元 Component)
State	古い. 現在の接続の状態を取得します。

メソッド

BeginDbTransaction(IsolationLevel)	古い. 派生クラスでオーバーライドされた場合、データベース トランザクションを開始します。 (継承元 DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	古い. データベース トランザクションを非同期に開始します。 (継承元 DbConnection)
BeginTransaction()	古い. データベースでトランザクションを開始します。
BeginTransaction(IsolationLevel)	古い. 指定した IsolationLevel 値を使用して、データベースでトランザクションを開始します。
BeginTransactionAsync(CancellationToken)	古い. データベース トランザクションを非同期に開始します。 (継承元 DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	古い. データベース トランザクションを非同期に開始します。 (継承元 DbConnection)
ChangeDatabase(String)	古い. 開いている OracleConnection の現在のデータベースを変更します。
ChangeDatabaseAsync(String, CancellationToken)	古い. 開いている接続の現在のデータベースを非同期に変更します。 (継承元 DbConnection)
ClearAllPools()	古い. 接続プールを空にします。
ClearPool(OracleConnection)	古い. 指定した接続に関連付けられている接続プールを空にします。
Close()	古い. データベースへの接続を閉じます。
CloseAsync()	古い. データベースへの接続を非同期に閉じます。 (継承元 DbConnection)
CreateBatch()	古い. DbBatch クラスを実装するプロバイダーのクラスの新しいインスタンスを返します。 (継承元 DbConnection)
CreateCommand()	古い. OracleCommand に関連付けられている OracleConnection オブジェクトを作成し、返します。
CreateDbBatch()	古い. 派生クラスでオーバーライドされると、 クラスを実装するプロバイダーのクラスの新しいインスタンスを DbBatch 返します。 (継承元 DbConnection)
CreateDbCommand()	古い. 派生クラスでオーバーライドされた場合、現在の接続に関連付けられている DbCommand オブジェクトを作成して返します。 (継承元 DbConnection)
CreateObjRef(Type)	古い. リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	古い. アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。 (継承元 DbConnection)
Dispose(Boolean)	古い. DbConnection によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。 (継承元 DbConnection)
DisposeAsync()	古い. 接続オブジェクトを非同期に破棄します。 (継承元 DbConnection)
EnlistDistributedTransaction(ITransaction)	古い. 分散トランザクションとして指定したトランザクションに参加します。
EnlistTransaction(Transaction)	古い. 分散トランザクションとして指定したトランザクションに参加します。
Equals(Object)	古い. 指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	古い. 既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject)
GetSchema()	古い. この OracleConnection のデータ ソースのスキーマ情報を返します。
GetSchema(String)	古い. スキーマ名として指定した文字列を使用して、この OracleConnection のデータ ソースのスキーマ情報を返します。
GetSchema(String, String[])	古い. スキーマ名に指定した文字列と制限値に指定した文字列配列を使用して、この OracleConnection のデータ ソースのスキーマ情報を返します。
GetSchemaAsync(CancellationToken)	古い. これは GetSchema() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 必要に応じて、cancellationToken を優先できます。 既定の実装は同期 GetSchema() コールを呼び出し、完了したタスクを返します。 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 GetSchema() によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 (継承元 DbConnection)
GetSchemaAsync(String, CancellationToken)	古い. これは GetSchema(String) の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 必要に応じて、cancellationToken を優先できます。 既定の実装は同期 GetSchema(String) コールを呼び出し、完了したタスクを返します。 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 GetSchema(String) によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 (継承元 DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	古い. これは GetSchema(String, String[]) の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 必要に応じて、cancellationToken を優先できます。 既定の実装は同期 GetSchema(String, String[]) コールを呼び出し、完了したタスクを返します。 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 GetSchema(String, String[]) によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 (継承元 DbConnection)
GetService(Type)	古い. Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (継承元 Component)
GetType()	古い. 現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	古い. 現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	古い. 現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	古い. StateChange イベントを発生させます。 (継承元 DbConnection)
Open()	古い. ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。
OpenAsync()	古い. Open() で指定した設定を使用してデータベース接続を開く ConnectionString の非同期バージョン。 このメソッドは、CancellationToken.None で仮想メソッド OpenAsync(CancellationToken) を呼び出します。 (継承元 DbConnection)
OpenAsync(CancellationToken)	古い. これは Open() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークン優先できます。 既定の実装は同期 Open() コールを呼び出し、完了したタスクを返します。 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 Open によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 返されたタスクが完了するまで DbConnection オブジェクトの他のメソッドとプロパティを呼び出さないでください。 (継承元 DbConnection)
ToString()	古い. Component の名前 (存在する場合) を格納する String を返します。 このメソッドはオーバーライドできません。 (継承元 Component)

イベント

Disposed	古い. Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component)
InfoMessage	古い. Oracle が警告メッセージまたは情報メッセージを送信したときに発生します。
StateChange	古い. 接続の状態が変化したときに発生します。 (継承元 DbConnection)

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

ICloneable.Clone()	古い. 現在のインスタンスのコピーである新しいオブジェクトを作成します。
IDbConnection.BeginTransaction()	古い. データベース トランザクションを開始します。 (継承元 DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	古い. 分離レベルを指定して、データベース トランザクションを開始します。 (継承元 DbConnection)
IDbConnection.CreateCommand()	古い. 現在の接続に関連付けられた DbCommand オブジェクトを作成し、返します。 (継承元 DbConnection)

こちらもご覧ください

• OracleDataAdapter
• OracleCommand