SqlConnection.Open メソッド

定義

名前空間:

System.Data.SqlClient

アセンブリ:

System.Data.dll

ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。

public:
 override void Open();

public override void Open ();

override this.Open : unit -> unit

Public Overrides Sub Open ()

例外

InvalidOperationException

データ ソースまたはサーバーを指定せずに接続を開くことはできません。

or

接続は既に開かれています。

SqlException

接続を開くときに発生した接続レベルのエラー。 Number プロパティに値 18487 または 18488 が含まれている場合、指定したパスワードの有効期限が切れているか、リセットする必要があることを示しています。 詳細については、 ChangePassword(String, String) メソッドを参照してください。

app.config ファイルの <system.data.localdb> タグに、使用できないか、不明な要素が含まれています。

ConfigurationErrorsException

<localdbinstances> セクションに、同じ名前のエントリが 2 つ含まれています。

例

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

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

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

注釈

が SqlConnection 使用可能な場合は、接続プールから開いている接続を描画します。 それ以外の場合は、SQL Serverのインスタンスへの新しい接続を確立します。

注意

が SqlConnection スコープ外になった場合、閉じません。 そのため、 を呼び出 Closeして接続を明示的に閉じる必要があります。

注意

SQL Serverのインスタンスに接続し、TCP/IP 以外のプロトコルを使用しているときに 1433 以外のポート番号を指定すると、メソッドはOpen失敗します。 1433 以外のポート番号を指定するには、接続文字列に "server=machinename,port number" を含め、TCP/IP プロトコルを使用します。

注意

.NET Framework Data Provider for SQL Serverでは、SQL デバッグを有効にして を開SqlConnectionくには、"アンマネージ アセンブリへの呼び出しを許可する" が有効になっている (SecurityPermissionSecurityPermissionFlag を にUnmanagedCode設定) したセキュリティ アクセス許可が必要です。

こちらもご覧ください

• ADO.NET での接続文字列
• SQL Server の接続プール (ADO.NET)
• ADO.NET でのデータ ソースへの接続
• ADO.NET の概要