OracleConnection

.NET Framework クラス ライブラリ リファレンス

OracleConnection イベント

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)
	InfoMessage	Oracle が警告メッセージまたは情報メッセージを送信したときに発生します。
	StateChange	イベントの状態が変更したときに発生します。 ( DbConnection から継承されます。)

参照

関連項目

OracleConnection クラス
System.Data.OracleClient 名前空間
OracleDataAdapter
OracleCommand クラス

OracleConnection クラス

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

名前空間: System.Data.OracleClient
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 OracleConnection
    Inherits DbConnection
    Implements ICloneable

Visual Basic (使用法)

Dim instance As OracleConnection

C#

public sealed class OracleConnection : DbConnection,
 ICloneable

C++

public ref class OracleConnection sealed :
 public DbConnection, ICloneable

J#

public final class OracleConnection extends
 DbConnection implements ICloneable

JScript

public final class OracleConnection extends
 DbConnection implements ICloneable

解説

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

OracleConnection オブジェクトのインスタンスを作成するアプリケーションは、直接的または間接的な呼び出し元すべてに対して、コードへの適切なアクセス許可を要求する、宣言セキュリティまたは強制セキュリティの要求を設定できます。OracleConnection は、OraclePermission オブジェクトを使用して、セキュリティ要求を作成します。ユーザーは、OraclePermissionAttribute オブジェクトを使用して、コードに適切なアクセス許可が設定されているかどうかを確認できます。また、ユーザーおよび管理者は、Code Access Security Policy Tool (Caspol.exe) を使用して、コンピュータ、ユーザー、エンタープライズの各レベルでセキュリティ ポリシーを変更できます。詳細については、「.NET Framework におけるセキュリティ」を参照してください。

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

OracleConnection オブジェクトが適用範囲外になる前に、必ず Close を呼び出して、OracleConnection オブジェクトを明示的に閉じる必要があります。これは、ガベージ コレクションがそれらをすぐに解放しない場合があるためです。ガベージ コレクションによる削除を待っている接続が多数存在する場合に、接続数の上限に達すると、このような遅延によりエラーが発生する場合があります。一方、Close を呼び出すことによって接続を閉じると、ネイティブ リソースをより効率的に使用でき、拡張性およびアプリケーション全体のパフォーマンスが向上します。

メモ
パフォーマンスの高いアプリケーションを配置するには、必要に応じて接続プールを使用します。ただし、.NET Framework Oracle 用データ プロバイダを使用する場合は、プロバイダが接続プールを自動的に管理するため、この機能を有効にする必要はありません。

使用例

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

Visual Basic

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

C#

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

C#

using System;
using System.Data;
using System.Data.OracleClient;

class Class1
{
    static void Main()
    {
    }

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

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbConnection
        System.Data.OracleClient.OracleConnection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OracleConnection メンバ
System.Data.OracleClient 名前空間
OracleDataAdapter
OracleCommand クラス

OracleConnection コンストラクタ ()

OracleConnection の新しいインスタンスを初期化します。

名前空間: System.Data.OracleClient
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New OracleConnection

C#

public OracleConnection ()

C++

public:
OracleConnection ()

J#

public OracleConnection ()

JScript

public function OracleConnection ()

使用例

OracleConnection を作成し、開く例を次に示します。

Visual Basic

Public Sub CreateOracleConnection()
    Dim connectionString As String
 = _
       "Data Source=Oracle8i;Integrated Security=yes"

    Using connection As New OracleConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
 _
           + ControlChars.NewLine + "DataSource: "
 + connection.DataSource)
    End Using
End Sub

C#

public void CreateOracleConnection()
{
    string connectionString = "Data Source=Oracle8i;Integrated
 Security=yes";
    using (OracleConnection connection = new
 OracleConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
            + "\nDataSource: " + connection.DataSource);
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OracleConnection クラス
OracleConnection メンバ
System.Data.OracleClient 名前空間

OracleConnection コンストラクタ (String)

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

名前空間: System.Data.OracleClient
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    connectionString As String _
)

Visual Basic (使用法)

Dim connectionString As String

Dim instance As New OracleConnection(connectionString)

C#

public OracleConnection (
    string connectionString
)

C++

public:
OracleConnection (
    String^ connectionString
)

J#

public OracleConnection (
    String connectionString
)

JScript

public function OracleConnection (
    connectionString : String
)

パラメータ

connectionString

データベースを開くために使用する接続。

使用例

OracleConnection を作成し、開く例を次に示します。

Visual Basic

Public Sub CreateOracleConnection()
    Dim connectionString As String
 = _
       "Data Source=Oracle8i;Integrated Security=yes"

    Using connection As New OracleConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
 _
           + ControlChars.NewLine + "DataSource: "
 + connection.DataSource)
    End Using
End Sub

C#

public void CreateOracleConnection()
{
    string connectionString = "Data Source=Oracle8i;Integrated
 Security=yes";
    using (OracleConnection connection = new
 OracleConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
            + "\nDataSource: " + connection.DataSource);
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OracleConnection クラス
OracleConnection メンバ
System.Data.OracleClient 名前空間

OracleConnection コンストラクタ

OracleConnection の新しいインスタンスを初期化します。
オーバーロードの一覧

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

参照

関連項目

OracleConnection クラス
OracleConnection メンバ
System.Data.OracleClient 名前空間

OracleConnection プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ConnectionString	オーバーライドされます。 Oracle データベースを開くために使用する文字列を取得または設定します。
	ConnectionTimeout	オーバーライドされます。 試行を中断してエラーを生成する前に、接続の確立時に待機する時間を取得します。
	Container	Component を格納している IContainer を取得します。 ( Component から継承されます。)
	Database	オーバーライドされます。 現在のデータベース、または接続が開いてから使用するデータベースの名前を取得します。
	DataSource	オーバーライドされます。 接続する Oracle サーバーの名前を取得します。
	ServerVersion	オーバーライドされます。 クライアントが接続しているサーバーのバージョンが示された文字列を取得します。
	Site	Component の ISite を取得または設定します。 ( Component から継承されます。)
	State	オーバーライドされます。 接続の現在の状態を取得します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。)

参照

関連項目

OracleConnection クラス
System.Data.OracleClient 名前空間
OracleDataAdapter
OracleCommand クラス

OracleConnection メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginTransaction	オーバーロードされます。 データベースでトランザクションを開始します。
	ChangeDatabase	オーバーライドされます。 開いている OracleConnection の現在のデータベースを変更します。
	ClearAllPools	接続プールを空にします。
	ClearPool	指定した接続に関連付けられている接続プールを空にします。
	Close	オーバーライドされます。 データベースへの接続を閉じます。
	CreateCommand	OracleConnection に関連付けられている OracleCommand オブジェクトを作成し、返します。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	EnlistDistributedTransaction	指定した分散トランザクションに参加します。
	EnlistTransaction	オーバーライドされます。 指定した分散トランザクションに参加します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetSchema	オーバーロードされます。 オーバーライドされます。 この OracleConnection のデータ ソースのスキーマ情報を返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	Open	オーバーライドされます。 ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)

プロテクト メソッド

	名前	説明
	BeginDbTransaction	データベース トランザクションを開始します。 ( DbConnection から継承されます。)
	CreateDbCommand	現在の接続に関連付けられている DbCommand オブジェクトを作成し、返します。 ( DbConnection から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	OnStateChange	StateChange イベントを発生させます。 ( DbConnection から継承されます。)

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

	名前	説明
	System.Data.IDbConnection.BeginTransaction	オーバーロードされます。
	System.Data.IDbConnection.ChangeDatabase
	System.Data.IDbConnection.CreateCommand
	System.ICloneable.Clone	このメンバの説明については、ICloneable.Clone のトピックを参照してください。

参照

関連項目

OracleConnection クラス
System.Data.OracleClient 名前空間
OracleDataAdapter
OracleCommand クラス

OracleConnection メンバ

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

OracleConnection データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	OracleConnection	オーバーロードされます。 OracleConnection の新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ConnectionString	オーバーライドされます。 Oracle データベースを開くために使用する文字列を取得または設定します。
	ConnectionTimeout	オーバーライドされます。 試行を中断してエラーを生成する前に、接続の確立時に待機する時間を取得します。
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	Database	オーバーライドされます。 現在のデータベース、または接続が開いてから使用するデータベースの名前を取得します。
	DataSource	オーバーライドされます。 接続する Oracle サーバーの名前を取得します。
	ServerVersion	オーバーライドされます。 クライアントが接続しているサーバーのバージョンが示された文字列を取得します。
	Site	Component の ISite を取得または設定します。(Component から継承されます。)
	State	オーバーライドされます。 接続の現在の状態を取得します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginTransaction	オーバーロードされます。 データベースでトランザクションを開始します。
	ChangeDatabase	オーバーライドされます。 開いている OracleConnection の現在のデータベースを変更します。
	ClearAllPools	接続プールを空にします。
	ClearPool	指定した接続に関連付けられている接続プールを空にします。
	Close	オーバーライドされます。 データベースへの接続を閉じます。
	CreateCommand	OracleConnection に関連付けられている OracleCommand オブジェクトを作成し、返します。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	EnlistDistributedTransaction	指定した分散トランザクションに参加します。
	EnlistTransaction	オーバーライドされます。 指定した分散トランザクションに参加します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetSchema	オーバーロードされます。 オーバーライドされます。 この OracleConnection のデータ ソースのスキーマ情報を返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	Open	オーバーライドされます。 ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)

プロテクト メソッド

	名前	説明
	BeginDbTransaction	データベース トランザクションを開始します。 (DbConnection から継承されます。)
	CreateDbCommand	現在の接続に関連付けられている DbCommand オブジェクトを作成し、返します。 (DbConnection から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	OnStateChange	StateChange イベントを発生させます。 (DbConnection から継承されます。)

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)
	InfoMessage	Oracle が警告メッセージまたは情報メッセージを送信したときに発生します。
	StateChange	イベントの状態が変更したときに発生します。(DbConnection から継承されます。)

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

	名前	説明
	System.Data.IDbConnection.BeginTransaction	オーバーロードされます。
	System.Data.IDbConnection.ChangeDatabase
	System.Data.IDbConnection.CreateCommand
	System.ICloneable.Clone	このメンバの説明については、ICloneable.Clone のトピックを参照してください。

参照

関連項目

OracleConnection クラス
System.Data.OracleClient 名前空間
OracleDataAdapter
OracleCommand クラス