Метод SqlCeConnection.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, быть пустым или содержать строку, состоящую только из пустых символов.

Метод 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 Класс

Пространство имен System.Data.SqlServerCe