SqlConnection.Open メソッド
ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。
Public Overridable Sub Open() Implements IDbConnection.Open
[C#]
public virtual void Open();
[C++]
public: virtual void Open();
[JScript]
public function Open();
実装
例外
例外の種類 | 条件 |
---|---|
InvalidOperationException | データ ソースまたはサーバーを指定せずに接続を開くことはできません。
または 接続が既に開いています。 |
SqlException | 接続を開くときに、接続レベルのエラーが発生しました。 |
解説
SqlConnection は、接続プール内で開いている接続が利用できる場合は、その接続を使用します。利用できない場合は、SQL Server のインスタンスへの新しい接続を確立します。
メモ SqlConnection は、適用範囲外では閉じられません。そのため、 Close または Dispose を呼び出して、明示的に接続を閉じる必要があります。
メモ TCP/IP 以外のプロトコルを使用して SQL Server のインスタンスに接続する場合、ポート番号を指定すると、 Open メソッドは失敗します。
メモ .NET Framework Data Provider for SQL Server では、SQL Debugging を有効にして SqlConnection を開くためには、[セキュリティ] の [アクセス許可の設定] を確認し、[アンマネージ アセンブリへの呼び出しを有効にする] が選択されている (SecurityPermission の SecurityPermissionFlag が UnmanagedCode に設定されている) 必要があります。
使用例
[Visual Basic, C#, C++] SqlConnection を作成し、接続を開いて、そのプロパティの一部を表示してから、接続を閉じる例を次に示します。
Public Sub CreateSqlConnection(myConnString As String)
Dim myConnection As New SqlConnection(myConnString)
myConnection.Open()
MessageBox.Show("ServerVersion: " & myConnection.ServerVersion & ControlChars.Cr & _
"State: " & myConnection.State.ToString())
myConnection.Close()
End Sub 'CreateSqlConnection
[C#]
public void CreateSqlConnection(string myConnString)
{
SqlConnection myConnection = new SqlConnection(myConnString);
myConnection.Open();
MessageBox.Show("ServerVersion: " + myConnection.ServerVersion +
"\nState: " + myConnection.State.ToString());
myConnection.Close();
}
[C++]
public:
void CreateSqlConnection(String* myConnString)
{
SqlConnection* myConnection = new SqlConnection(myConnString);
myConnection->Open();
MessageBox::Show(String::Format( S"ServerVersion: {0}\nState: {1}",
myConnection->ServerVersion, __box(myConnection->State)));
myConnection->Close();
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
参照
SqlConnection クラス | SqlConnection メンバ | System.Data.SqlClient 名前空間 | Close