次の方法で共有


OracleConnection クラス

定義

注意事項

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

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

public ref class OracleConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public ref class OracleConnection sealed : System::Data::Common::DbConnection, ICloneable
public sealed class OracleConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
public sealed class OracleConnection : 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
type OracleConnection = class
    inherit Component
    interface ICloneable
    interface IDbConnection
    interface IDisposable
type OracleConnection = class
    inherit DbConnection
    interface 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 Component
Implements ICloneable, IDbConnection, IDisposable
Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable
継承
継承
属性
実装

次の例では、 と を OracleCommand 作成します OracleConnectionOracleConnectionが開き、 プロパティとして設定されます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) OracleConnectionConnection オブジェクトとは異なり、 プロパティはサポート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
古い.

この DbProviderFactoryDbConnection を取得します。

(継承元 DbConnection)
DesignMode
古い.

Component が現在デザイン モードかどうかを示す値を取得します。

(継承元 Component)
Events
古い.

Component に結び付けられているイベント ハンドラーのリストを取得します。

(継承元 Component)
ServerVersion
古い.

クライアントが接続しているサーバーのバージョンが示された文字列を取得します。

Site
古い.

ComponentISite を取得または設定します。

(継承元 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()
古い.

Component によって使用されているすべてのリソースを解放します。

(継承元 Component)
Dispose()
古い.

アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。

(継承元 DbConnection)
Dispose(Boolean)
古い.

Component によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

(継承元 Component)
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
古い.

接続の状態が変化したときに発生します。

StateChange
古い.

接続の状態が変化したときに発生します。

(継承元 DbConnection)

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

ICloneable.Clone()
古い.

現在のインスタンスのコピーである新しいオブジェクトを作成します。

IDbConnection.BeginTransaction()
古い.

データベース トランザクションを開始します。

IDbConnection.BeginTransaction()
古い.

データベース トランザクションを開始します。

(継承元 DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)
古い.

指定した IsolationLevel 値を使用して、データベース トランザクションを開始します。

IDbConnection.BeginTransaction(IsolationLevel)
古い.

分離レベルを指定して、データベース トランザクションを開始します。

(継承元 DbConnection)
IDbConnection.ChangeDatabase(String)
古い.

開いている Connection オブジェクトの現在のデータベースを変更します。

IDbConnection.CreateCommand()
古い.

接続に関連付けられた Command オブジェクトを作成し、返します。

IDbConnection.CreateCommand()
古い.

現在の接続に関連付けられた DbCommand オブジェクトを作成し、返します。

(継承元 DbConnection)

適用対象

こちらもご覧ください