次の方法で共有

SqlCeConnection.ChangeDatabase Method

  • [アーティクル]

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

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

構文

'宣言
Public Overrides Sub ChangeDatabase ( _
    value As String _
)

public override void ChangeDatabase (
    string value
)

public:
virtual void ChangeDatabase (
    String^ value
) override

public void ChangeDatabase (
    String value
)

public override function ChangeDatabase (
    value : String
)

パラメータ

  • value
    データベース名。

戻り値

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

例外

例外の種類 条件
ArgumentException

データベース名が有効ではありません。
InvalidOperationException

接続が開いていません。
SqlCeException

データベースを変更できません。

解説

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

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

スレッド セーフ

この型の public static (Visual Basic では Shared ) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

Windows Vista、Windows Mobile 5.0、Windows XP Professional with Service Pack 2 (SP2)、Windows Server 2003、Windows Mobile 2003 for Pocket PC、Windows CE 5.0
バージョン情報
.NET Framework および .NET Compact Framework
3.5 でサポート
.NET Framework
3.0 でサポート
.NET Compact Framework および .Net Framework
2.0 でサポート

参照

リファレンス

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace