SqlConnection.Close メソッド

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

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

実装

IDbConnection.Close

例外

例外の種類	条件
SqlException	接続を開くときに、接続レベルのエラーが発生しました。

解説

Close メソッドは、保留中のすべてのトランザクションをロールバックします。次に、接続を接続プールに解放します。接続プールが無効の場合は、接続を閉じます。

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

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

使用例

[Visual Basic, C#, C++] SqlConnection を作成し、接続を開いて、そのプロパティの一部を表示してから、接続を閉じる例を次に示します。

 
Public Sub CreateSqlConnection(myConnString As String)
    Dim myConnection As New SqlConnection(myConnString)
    myConnection.Open()
    MessageBox.Show("ServerVersion: " & myConnection.ServerVersion & ControlChars.Cr & _
                    "State: " & myConnection.State.ToString())
    myConnection.Close()
End Sub 'CreateSqlConnection

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

[C++] 
public:
void CreateSqlConnection(String* myConnString) 
 {
    SqlConnection* myConnection = new SqlConnection(myConnString);
    myConnection->Open();
    MessageBox::Show(String::Format( S"ServerVersion: {0}\nState: {1}",
       myConnection->ServerVersion, __box(myConnection->State)));
    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 ファミリ, .NET Compact Framework - Windows CE .NET

参照

SqlConnection クラス | SqlConnection メンバ | System.Data.SqlClient 名前空間 | Open