SqlCeConnection.ChangeDatabase Method

Artigo
01/14/2011

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

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
O nome do banco de dados.

Valor de retorno

True se o banco de dados foi alterado com êxito; caso contrário, false.

Exceções

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

Exemplo

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

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

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
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace

Compartilhar via