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

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

Vea también

Referencia

SqlCeConnection Clase

Espacio de nombres System.Data.SqlServerCe