OdbcConnection.ReleaseObjectPool メソッド

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

基になる最後の接続が解放されたら ODBC ドライバ マネージャの環境ハンドルを解放できることを示します。

Public Shared Sub ReleaseObjectPool()
[C#]
public static void ReleaseObjectPool();
[C++]
public: static void ReleaseObjectPool();
[JScript]
public static function ReleaseObjectPool();

解説

ReleaseObjectPool を呼び出して、ODBC の環境ハンドルを解放できます。このメソッドは、その接続オブジェクトを使用しなくなった場合などに呼び出すことができます。環境内のすべての接続が閉じると、その環境は破棄できます。このメソッドを呼び出すだけでは、環境内のアクティブな接続は実際には解放されないことに注意してください。

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

1. Close を呼び出して、 OdbcConnection オブジェクトを環境から解放します。
2. 各接続オブジェクトをタイムアウトさせます。
3. ReleaseObjectPool を呼び出します。
4. ガベージ コレクションを起動します。

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

環境ハンドルが解放された後、新しい OdbcConnection が要求されたときに新しい環境が作成されます。

使用例

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

 
Public Sub CreateOdbcConnection(myConnString As String)
    Dim myConnection As New OdbcConnection(myConnString)
    myConnection.Open()
    MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _
       + ControlChars.Cr + "State: " + myConnection.State.ToString())
    myConnection.Close()
    OdbcConnection.ReleaseObjectPool()
End Sub

[C#] 
public void CreateOdbcConnection(string myConnString) 
{
   OdbcConnection myConnection = new OdbcConnection(myConnString);
   myConnection.Open();
   MessageBox.Show("ServerVersion: " + myConnection.ServerVersion
      + "\nState: " + myConnection.State.ToString());
   myConnection.Close();
   OdbcConnection.ReleaseObjectPool();
}

[C++] 
public:
    void CreateOdbcConnection(String* myConnString)
    {
        OdbcConnection* myConnection = new OdbcConnection(myConnString);
        myConnection->Open();
        MessageBox::Show(String::Concat(S"ServerVersion: ", myConnection->ServerVersion,
            S"\nState: ", __box(myConnection->State)));
        myConnection->Close();
        OdbcConnection::ReleaseObjectPool();
    };

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

OdbcConnection クラス | OdbcConnection メンバ | System.Data.Odbc 名前空間