SqlConnection.Open メソッド

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

SqlConnection.Open メソッド

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

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

Visual Basic (宣言)

Public Overrides Sub Open

Visual Basic (使用法)

Dim instance As SqlConnection

instance.Open

C#

public override void Open ()

C++

public:
virtual void Open () override

J#

public void Open ()

JScript

public override function Open ()

例外

例外の種類	条件
InvalidOperationException	データ ソースまたはサーバーを指定せずに接続を開くことはできません。 または 接続が既に開いています。
SqlException	接続を開くときに、接続レベルのエラーが発生しました。Number プロパティに値 18487 または 18488 が含まれている場合は、指定したパスワードの有効期限が切れているか、またはパスワードをリセットする必要があることを示します。詳細については、ChangePassword メソッドのトピックを参照してください。

解説

SqlConnection は、接続プール内で開いている接続が利用できる場合は、その接続を使用します。利用できない場合は、SQL Server のインスタンスへの新しい接続を確立します。

メモ
SqlConnection は、適用範囲外では閉じられません。そのため、Close を呼び出して、明示的に接続を閉じる必要があります。

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

メモ
.NET Framework SQL Server 用データ プロバイダでは、SQL Debugging を有効にして SqlConnection を開くためには、[セキュリティ] の [アクセス許可の設定] を確認し、[アンマネージ アセンブリへの呼び出しを有効にする] が選択されている (SecurityPermission の SecurityPermissionFlag が UnmanagedCode に設定されている) 必要があります。

使用例

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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlConnection クラス
SqlConnection メンバ
System.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得
.NET Framework Data Provider for SQL Server の使用