Compartilhar via


Método SqlCeConnection.ChangeDatabase

Altera o banco de dados atual para uma SqlCeConnection aberta.

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
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

Implementa

IDbConnection.ChangeDatabase(String)

Exceções

Exceção Condição
ArgumentException

O nome do banco de dados não é válido.

InvalidOperationException

A conexão não está aberta.

SqlCeException

Não é possível alterar os bancos de dados.

Comentários

O nome fornecido no parâmetro value deve ser um nome de banco de dados válido. O nome deve ser o caminho completo do banco de dados; por exemplo, "\my app\myDB.sdf". O parâmetro value não pode ser nulluma referência nula (Nothing no Visual Basic), estar vazio ou conter uma cadeia de caracteres apenas com caracteres em branco.

ChangeDatabase aplica ao novo banco de dados as mesmas propriedades usadas para abrir o banco de dados atual, exceto a senha, que será definida como uma cadeia de caracteres vazia.

Se o novo banco de dados exigir uma senha, a chamada falhará. Se isso ocorrer, para alterar os bancos de dados, será necessário fechar a conexão original, especificar uma nova cadeia de caracteres de conexão e abri-la novamente.

Exemplos

O exemplo a seguir mostra como alternar entre bancos de dados preservando as opções de conexão originais.

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

Consulte também

Referência

SqlCeConnection Classe

Namespace System.Data.SqlServerCe