Método ChangeDatabase

Artigo
01/17/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 _
)
'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
O nome do banco de dados.

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 null Nothing nullptr unit uma 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

Membros SqlCeConnection

Namespace System.Data.SqlServerCe

Partilhar via