OleDbConnection.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 です。
実装
解説
次の状態の変更が許可されます。
- Closed から Open へ。接続オブジェクトの Open メソッドを使用します。
- Open から Closed。接続オブジェクトの Close メソッドまたは Dispose メソッドを使用します。
メモ State プロパティを呼び出すと、開いている接続の OLE DB DBPROP_CONNECTIONSTATUS プロパティがその都度呼び出されるため、アプリケーションのオーバーヘッドが増します。
使用例
[Visual Basic, C#, C++] OleDbConnection 派生クラスのインスタンスを作成し、その ConnectionString を設定して、 State を表示する例を次に示します。
Public Sub createOleDbConnection()
Dim myConnection As New OleDbConnection()
myConnection.ConnectionString = _
"Provider=SQLOLEDB;Data Source=localhost;Initial Catalog=Northwind;Integrated Security=SSPI;"
myConnection.Open()
MessageBox.Show("Connection State: " + myConnection.State)
myConnection.Close()
End Sub
[C#]
public void createOleDbConnection()
{
OleDbConnection myConnection = new OleDbConnection();
myConnection.ConnectionString = "Provider=SQLOLEDB;Data Source=localhost;Initial Catalog=Northwind;Integrated Security=SSPI;";
myConnection.Open();
MessageBox.Show("Connection State: " + myConnection.State);
myConnection.Close();
}
[C++]
public:
void createOleDbConnection()
{
OleDbConnection* myConnection = new OleDbConnection();
myConnection->ConnectionString = S"Provider=SQLOLEDB;Data Source=localhost;Initial Catalog=Northwind;Integrated Security=SSPI;";
myConnection->Open();
MessageBox::Show(String::Format( S"Connection State: {0}", __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 ファミリ
参照
OleDbConnection クラス | OleDbConnection メンバ | System.Data.OleDb 名前空間