ChangeDatabase メソッド
開いている SqlCeConnection の現在のデータベースを変更します。
名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (System.Data.SqlServerCe.dll)
構文
'宣言
Public Overrides Sub ChangeDatabase ( _
value As String _
)
'使用
Dim instance As SqlCeConnection
Dim value As String
instance.ChangeDatabase(value)
public override void ChangeDatabase(
string value
)
public:
virtual void ChangeDatabase(
String^ value
) override
abstract ChangeDatabase :
value:string -> unit
override ChangeDatabase :
value:string -> unit
public override function ChangeDatabase(
value : String
)
パラメーター
- value
型: System. . :: . .String
データベース名。
実装
IDbConnection. . :: . .ChangeDatabase(String)
例外
| 例外 | 条件 |
|---|---|
| ArgumentException | データベース名が有効ではありません。 |
| InvalidOperationException | 接続が開いていません。 |
| SqlCeException | データベースを変更できません。 |
説明
value パラメーターで指定する名前は、有効なデータベース名である必要があります。名前は、\my app\myDB.sdf のように、データベースの完全パスにする必要があります。value パラメーターに、 null Nothing nullptr unit NULL 参照 (Visual Basic では Nothing) 、空の値、または空白文字だけの文字列は指定できません。
ChangeDatabase では、パスワードを除き、現在のデータベースを開くときに使用したプロパティが新しいデータベースに適用されます。パスワードには、空の文字列が設定されます。
新しいデータベースにパスワードが必要な場合、この呼び出しは失敗します。この場合、データベースを変更するには、元の接続を閉じ、新しい接続文字列を指定してから、接続を再度開く必要があります。
使用例
元の接続オプションを保存したままデータベースを切り替える例を次に示します。
Dim conn As New SqlCeConnection()
' Set some connection string properties e.g.:
'
conn.ConnectionString = _
"Persist Security Info = False; Data Source = 'SalesData.sdf';" & _
"Password = '<password>'; File Mode = 'shared read'; " & _
"Max Database Size = 256; Max Buffer Size = 1024"
conn.Open()
' You can change the database while preserving
' the orignal connection options
'
conn.ChangeDatabase("SupportData.sdf")
SqlCeConnection conn = new SqlCeConnection();
// Set some connection string properties e.g.:
//
conn.ConnectionString =
"Persist Security Info = False; Data Source = 'SalesData.sdf';" +
"Password = '<password>'; File Mode = 'shared read'; " +
"Max Database Size = 256; Max Buffer Size = 1024";
conn.Open();
// You can change the database while preserving
// the orignal connection options
//
conn.ChangeDatabase("SupportData.sdf");