SqlConnection.Open メソッド

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.SqlClient.dll
アセンブリ:
System.Data.dll
ソース:
System.Data.SqlClient.notsupported.cs

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 ()

実装

Open()

例外

InvalidOperationException

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

または

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

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のインスタンスへの新しい接続を確立します。

Note

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

Note

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

Note

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

適用対象

こちらもご覧ください