SqlCeConnection.ChangeDatabase Método
Cambia la base de datos actual de una conexión SqlCeConnection abierta.
Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)
Sintaxis
'Declaración
Public Overrides Sub ChangeDatabase ( _
value As String _
)
'Uso
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
)
Parámetros
- value
Tipo: System.String
Nombre de la base de datos.
Implementa
IDbConnection.ChangeDatabase(String)
Excepciones
Excepción | Condición |
---|---|
ArgumentException | El nombre de la base de datos no es válido. |
InvalidOperationException | La conexión no está abierta. |
SqlCeException | Las bases de datos no pueden cambiarse. |
Comentarios
El nombre proporcionado en el parámetro value debe ser un nombre de base de datos válido. El nombre debe ser la ruta de acceso completa de la base de datos; por ejemplo, "\my app\myDB.sdf". El parámetro value no puede tener un valor nulles una referencia NULL (Nothing en Visual Basic)., ni estar vacío ni contener ninguna cadena formada solo por caracteres en blanco.
ChangeDatabase aplica a la nueva base de datos las mismas propiedades que se han utilizado para abrir la base de datos actual, a excepción de la contraseña, que se establecerá en una cadena vacía.
Si la nueva base de datos requiere una contraseña, esta llamada producirá un error. Si esto ocurre, para cambiar las bases de datos, hay que cerrar la conexión original, especificar una nueva cadena de conexión y volver a abrir la conexión.
Ejemplos
El ejemplo siguiente muestra cómo cambiar entre bases de datos conservando las opciones de conexión originales.
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");