メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。
開いている SqlCeConnection の現在のデータベースを変更します。
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
データベース名。
戻り値
データベースが正常に変更された場合は true 。それ以外の場合は false 。
実装
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentException | データベース名が有効ではありません。 |
| InvalidOperationException | 接続が開いていません。 |
| SqlCeException | データベースを変更できません。 |
解説
value パラメータで指定する名前は、有効なデータベース名である必要があります。名前は、\my app\myDB.sdf のように、データベースの完全パスにする必要があります。 value パラメータは、null 値、空の値、または空白文字だけの文字列にはできません。
ChangeDatabase では、パスワードを除き、現在のデータベースを開くときに使用したプロパティが新しいデータベースに適用されます。パスワードには、空の文字列が設定されます。
新しいデータベースにパスワードが必要な場合、この呼び出しは失敗します。この場合、データベースを変更するには、元の接続を閉じ、新しい接続文字列を指定してから、接続を再度開く必要があります。
必要条件
プラットフォーム: .NET Compact Framework - Windows CE .NET
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
SqlCeConnection クラス | SqlCeConnection メンバ | System.Data.SqlServerCe 名前空間