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

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

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

SqlConnection.Close メソッド

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

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

Visual Basic (宣言)

Public Overrides Sub Close

Visual Basic (使用法)

Dim instance As SqlConnection

instance.Close

public override void Close ()

C++

public:
virtual void Close () override

public void Close ()

JScript

public override function Close ()

例外

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

解説

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

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

注意

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

使用例

SqlConnection を作成して開き、そのプロパティの一部を表示する例を次に示します。接続は、using ブロックの末尾で自動的に閉じられます。

Visual Basic

Private Sub OpenSqlConnection(ByVal
 connectionString As String)
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    End Using
End Sub

private static void OpenSqlConnection(string
 connectionString)
{
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("State: {0}", connection.State);
    }
}