OleDbConnection.ReleaseObjectPool メソッド

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

OleDbConnection.ReleaseObjectPool メソッド

基になる最後の接続が解放されたときに、OleDbConnection オブジェクトのプールを削除できることを示します。

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

Visual Basic (宣言)

Public Shared Sub ReleaseObjectPool

Visual Basic (使用法)

OleDbConnection.ReleaseObjectPool

C#

public static void ReleaseObjectPool
 ()

C++

public:
static void ReleaseObjectPool ()

J#

public static void ReleaseObjectPool
 ()

JScript

public static function ReleaseObjectPool
 ()

解説

ReleaseObjectPool を呼び出すと、プールされた OleDbConnection オブジェクト用に予約されていたリソースを解放できます。たとえば、接続オブジェクトをしばらくの間使用しない場合に、このメソッドを呼び出します。その間も、OLE DB サービスは、通常、プールされた接続をアクティブなまま維持します。このメソッドを呼び出すだけでは、プール内のアクティブな接続は実際には解放されないことに注意してください。

プールを最終的に破棄するには、次の処理を実行する必要があります。

1. Close を呼び出して、接続オブジェクトをプールに返します。

2. 各接続オブジェクトをプールからタイムアウトさせます。

3. ReleaseObjectPool を呼び出します。

4. ガベージ コレクションを起動します。

逆に、すべてのアクティブな接続に対して Close を呼び出し、ガベージ コレクションを起動しても、ReleaseObjectPool を呼び出さない限り、プールされたオブジェクト用に予約されたリソースは利用可能な状態で残されます。

使用例

OleDbConnection を作成し、接続を開いて、そのプロパティの一部を表示してから、接続を閉じ、オブジェクト プールを解放してリソースを節約する例を次に示します。

Visual Basic

Public Sub OpenConnection(ByVal
 connectionString As String)

    Using connection As New OleDbConnection(connectionString)
        Try
            connection.Open()
            Console.WriteLine("Connection.State: {0}",
 _
                connection.State)

            connection.Close()
            OleDbConnection.ReleaseObjectPool()
            Console.WriteLine("Connection.State: {0}",
 _
                connection.State)

        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Using
End Sub

C#

static void OpenConnection(string
 connectionString)
{
    using (OleDbConnection connection = new
 OleDbConnection(connectionString))
    {
        try
        {
            connection.Open();
            Console.WriteLine("Connection.State: {0}", connection.State);

            connection.Close();
            OleDbConnection.ReleaseObjectPool();
            Console.WriteLine("Connection.State: {0}", connection.State);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }

C#

using System;
using System.Data;
using System.Data.OleDb;

class Class1
{
    static void Main()
    {
        string x = "Provider=SQLOLEDB;Data Source=(local);Initial
 Catalog=AdventureWorks;"
            + "Integrated Security=SSPI";
        OpenConnection(x);
        Console.ReadLine();
    }

    static void OpenConnection(string
 connectionString)
    {
        using (OleDbConnection connection = new
 OleDbConnection(connectionString))
        {
            try
            {
                connection.Open();
                Console.WriteLine("Connection.State: {0}", connection.State);

                connection.Close();
                OleDbConnection.ReleaseObjectPool();
                Console.WriteLine("Connection.State: {0}", connection.State);
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
            }
            // The connection is automatically closed when the
            // code exits the using block.
        }

プラットフォーム

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、1.0

参照

関連項目
OleDbConnection クラス
OleDbConnection メンバ
System.Data.OleDb 名前空間
その他の技術情報
データ ソースへの接続
接続プールについて