OracleConnection クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

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

public sealed class OracleConnection : DbConnection,
 ICloneable

C++

public ref class OracleConnection sealed :
 public DbConnection, ICloneable

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 メソッドもサポートしていません。

メモ

.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

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

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) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。