SqlCeConnection.ChangeDatabase メソッド

.NET Framework クラス ライブラリ リファレンス

SqlCeConnection.ChangeDatabase メソッド

開いている SqlCeConnection の現在のデータベースを変更します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub ChangeDatabase
 ( _
    value As String _
)

Visual Basic (使用法)

Dim instance As SqlCeConnection
Dim value As String

instance.ChangeDatabase(value)

C#

public override void ChangeDatabase (
    string value
)

C++

public:
virtual void ChangeDatabase (
    String^ value
) override

J#

public void ChangeDatabase (
    String value
)

JScript

public override function ChangeDatabase (
    value : String
)

パラメータ

value

データベース名。

戻り値
データベースが正常に変更された場合は、true。それ以外の場合は、false。

例外

例外の種類	条件
ArgumentException	データベース名が有効ではありません。
InvalidOperationException	接続が開いていません。
SqlCeException	データベースを変更できません。

解説

value パラメータで指定する名前は、有効なデータベース名である必要があります。名前は、\my app\myDB.sdf のように、データベースの完全パスにする必要があります。value パラメータは、null 参照 (Visual Basic では Nothing) 値、空の値、または空白文字だけの文字列にはできません。

ChangeDatabase では、パスワードを除き、現在のデータベースを開くときに使用したプロパティが新しいデータベースに適用されます。パスワードには、空の文字列が設定されます。

新しいデータベースにパスワードが必要な場合、この呼び出しは失敗します。この場合、データベースを変更するには、元の接続を閉じ、新しい接続文字列を指定してから、接続を再度開く必要があります。

使用例

元の接続オプションを保存したままデータベースを切り替える例を次に示します。

Visual Basic

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")

C#

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");

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeConnection クラス
SqlCeConnection メンバ
System.Data.SqlServerCe 名前空間