SqlCeConnection.ChangeDatabase メソッドとは何？わかりやすく解説 Weblio辞書

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

public override void ChangeDatabase (
    string value
)

C++

public:
virtual void ChangeDatabase (
    String^ value
) override

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

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