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)

例外

説明

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

関連項目

参照

SqlCeConnection クラス

SqlCeConnection メンバー

System.Data.SqlServerCe 名前空間