OdbcConnection.Close メソッド

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

データ ソースへの接続を閉じます。このメソッドは、開いている接続を閉じるための最も好ましいメソッドです。

Public Overridable Sub Close() Implements IDbConnection.Close
[C#]
public virtual void Close();
[C++]
public: virtual void Close();
[JScript]
public function Close();

実装

IDbConnection.Close

解説

Close メソッドは、保留中のすべてのトランザクションをロールバックします。次に、接続を接続プールに解放します。接続プールが無効の場合は、接続を閉じます。 StateChange イベントの処理中に Close を呼び出す場合は、追加の StateChange イベントは発生しません。

アプリケーションが Close を複数回呼び出しても、例外は発生しません。

メモ   .NET Framework Data Provider for ODBC を使用する場合は、ODBC ドライバ マネージャが接続プールを自動的に管理するため、この機能を有効にする必要はありません。接続プールの有効化および無効化の詳細については、Microsoft Open Database Connectivity (ODBC) のドキュメントを参照してください。

注意   クラスの Finalize メソッドで、Connection、DataReader、またはその他のマネージ オブジェクトの Close または Dispose を呼び出すことは避けてください。ファイナライザでは、クラスが直接所有しているアンマネージ リソースだけを解放してください。アンマネージ リソースを一切所有しないクラスの場合は、クラス定義の中に Finalize メソッドを含めないでください。詳細については、「 ガベージ コレクションのプログラミング 」を参照してください。

使用例

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

[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)->ToString()));
        myConnection->Close();
    };

[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 名前空間 | Open