OleDbConnection.ChangeDatabase メソッド
開いている OleDbConnection の現在のデータベースを変更します。
Public Overridable Sub ChangeDatabase( _
ByVal value As String _) Implements IDbConnection.ChangeDatabase
[C#]
public virtual void ChangeDatabase(stringvalue);
[C++]
public: virtual void ChangeDatabase(String* value);
[JScript]
public function ChangeDatabase(
value : String);
パラメータ
- value
データベース名。
実装
例外
例外の種類 | 条件 |
---|---|
ArgumentException | データベース名が有効ではありません。 |
InvalidOperationException | 接続が開いていません。 |
OleDbException | データベースを変更できません。 |
解説
database パラメータで指定する値は、有効なデータベース名である必要があります。 database パラメータは、null 値、空の文字列、または空白文字だけの文字列にはできません。
使用例
[Visual Basic, C#, C++] OleDbConnection を作成し、その読み取り専用プロパティの一部を表示する例を次に示します。
Public Sub CreateOleDbConnection()
Dim myConnString As String = _
"Provider=SQLOLEDB;Data Source=localhost;Initial Catalog=Northwind;Integrated Security=SSPI;"
Dim myConnection As New OleDbConnection(myConnString)
myConnection.Open()
MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _
+ ControlChars.NewLine + "Database: " + myConnection.Database)
myConnection.ChangeDatabase("pubs")
MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _
+ ControlChars.NewLine + "Database: " + myConnection.Database)
myConnection.Close()
End Sub
[C#]
public void CreateOleDbConnection()
{
string myConnString = "Provider=SQLOLEDB;Data Source=localhost;Initial Catalog=Northwind;Integrated Security=SSPI;";
OleDbConnection myConnection = new OleDbConnection(myConnString);
myConnection.Open();
MessageBox.Show("ServerVersion: " + myConnection.ServerVersion
+ "\nDatabase: " + myConnection.Database);
myConnection.ChangeDatabase("pubs");
MessageBox.Show("ServerVersion: " + myConnection.ServerVersion
+ "\nDatabase: " + myConnection.Database);
myConnection.Close();
}
[C++]
public:
void CreateOleDbConnection()
{
String* myConnString = S"Provider=SQLOLEDB;Data Source=localhost;Initial Catalog=Northwind;Integrated Security=SSPI;";
OleDbConnection* myConnection = new OleDbConnection(myConnString);
myConnection->Open();
MessageBox::Show(String::Format( S"ServerVersion: {0}\nDatabase: {1}", myConnection->ServerVersion, myConnection->Database ));
myConnection->ChangeDatabase(S"pubs");
MessageBox::Show(String::Format( S"ServerVersion: {0}\nDatabase: {1}", myConnection->ServerVersion, myConnection->Database ));
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 名前空間 | Database