SqlConnection.Open メソッド

定義

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

public:
 override void Open();
public:
 virtual void Open();
public override void Open ();
public void Open ();
override this.Open : unit -> unit
abstract member Open : unit -> unit
override this.Open : unit -> unit
Public Overrides Sub Open ()
Public Sub Open ()

実装

例外

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

or

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

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

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

<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 プロトコルを使用します。

注意

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

適用対象

こちらもご覧ください