SqlCeConnection.ChangeDatabase Method

Статья
01/14/2011

Осуществляет смену текущей базы данных для открытого соединения 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");

Многопоточное использование

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

Платформы

Платформы разработки

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

Поделиться через