OdbcConnection.State プロパティ

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

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

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 メソッドを使用します。

メモ   開いている接続で State プロパティを呼び出すと、呼び出しのたびに、接続が有効であるかどうかを確認するために SQL_ATTR_CONNECTION_DEAD から基になる ODBC ドライバが呼び出されるため、アプリケーションのオーバーヘッドが増加します。

使用例

[Visual Basic, C#, C++] OdbcConnection 派生クラスのインスタンスを作成し、その ConnectionString を設定してから、 State を表示する例を次に示します。

 
Public Sub createOdbcConnection()
    Dim myConnection As New OdbcConnection()
    myConnection.ConnectionString = _
       "DRIVER={SQL Server};SERVER=MyServer;Trusted_connection=yes;DATABASE=northwind;"
    myConnection.Open()
    MessageBox.Show("Connection State: " + myConnection.State)
    myConnection.Close()
End Sub

[C#] 
public void createOdbcConnection()
{
   OdbcConnection myConnection = new OdbcConnection();
   myConnection.ConnectionString = "DRIVER={SQL Server};SERVER=MyServer;Trusted_connection=yes;DATABASE=northwind;";
   myConnection.Open();
   MessageBox.Show("Connection State: " + myConnection.State);
   myConnection.Close();
}

[C++] 
public:
    void createOdbcConnection()
    {
        OdbcConnection* myConnection = new OdbcConnection();
        myConnection->ConnectionString = S"DRIVER= {SQL Server};SERVER=MyServer;Trusted_connection=yes;DATABASE=northwind;";
        myConnection->Open();
        MessageBox::Show(String::Concat(S"Connection State: ", __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 ファミリ

参照

OdbcConnection クラス | OdbcConnection メンバ | System.Data.Odbc 名前空間