Compartir a través de

SqlCeConnection.ChangeDatabase Method

  • Artículo

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 _
)

public override void ChangeDatabase (
    string value
)

public:
virtual void ChangeDatabase (
    String^ value
) override

public void ChangeDatabase (
    String value
)

public override function ChangeDatabase (
    value : String
)

Parámetros

  • value
    Nombre de la base de datos.

Valor devuelto

True si la base de datos se ha modificado correctamente; en caso contrario, false.

Excepciones

Tipo de 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.

Notas

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 null, ni estar vacío, ni contener ninguna cadena formada sólo 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.

Ejemplo

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

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

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
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace