OleDbConnection.ReleaseObjectPool メソッドとは何？わかりやすく解説 Weblio辞書

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

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

OleDbConnection.ReleaseObjectPool メソッド

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

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

Visual Basic (宣言)

Public Shared Sub ReleaseObjectPool

Visual Basic (使用法)

OleDbConnection.ReleaseObjectPool

public static void ReleaseObjectPool
 ()

C++

public:
static void ReleaseObjectPool ()

public static void ReleaseObjectPool
 ()

JScript

public static function ReleaseObjectPool
 ()

解説

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

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

逆に、すべてのアクティブな接続に対して 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

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.
    }

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.
        }