SqlConnection.State プロパティ

接続の現在の状態を取得します。

Public Overridable ReadOnly Property State As ConnectionState  _   Implements IDbConnection.State
[C#]
public virtual ConnectionState State {get;}
[C++]
public: __property virtual ConnectionState get_State();
[JScript]
public function get State() : ConnectionState;

プロパティ値

ConnectionState 値のビットごとの組み合わせ。既定値は Closed です。

実装

IDbConnection.State

解説

次の状態の変更が許可されます。

• Closed から Open へ。接続オブジェクトの Open メソッドを使用します。
• Open から Closed。接続オブジェクトの Close メソッドまたは Dispose メソッドを使用します。

使用例

[Visual Basic, C#, C++] SqlConnection を作成し、その読み取り専用プロパティの一部を表示する例を次に示します。

 
Public Sub CreateSqlConnection()
    Dim myConnectString As String = _
       "Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer"
    Dim myConnection As New SqlConnection(myConnectString)
    myConnection.Open()
    MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _
       + ControlChars.Cr + "State: " + myConnection.State.ToString())
    myConnection.Close()
End Sub

[C#] 
public void CreateSqlConnection() 
{
   string myConnectString =
      "Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer";
   SqlConnection myConnection = new SqlConnection(myConnectString);
   myConnection.Open();
   MessageBox.Show("ServerVersion: " + myConnection.ServerVersion
      + "\nState: " + myConnection.State.ToString());
   myConnection.Close();
}

[C++] 
public:
 void CreateSqlConnection() 
 {
    String* myConnectString =
       S"Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer";
    SqlConnection* myConnection = new SqlConnection(myConnectString);
    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 名前空間