OdbcConnection.ChangeDatabase(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Altera o banco de dados atual associado a um OdbcConnection aberto.
public:
override void ChangeDatabase(System::String ^ value);
public:
virtual void ChangeDatabase(System::String ^ value);
public override void ChangeDatabase (string value);
public void ChangeDatabase (string value);
override this.ChangeDatabase : string -> unit
abstract member ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
Public Overrides Sub ChangeDatabase (value As String)
Public Sub ChangeDatabase (value As String)
Parâmetros
- value
- String
Nome do banco de dados.
Implementações
Exceções
O nome do banco de dados não é válido.
A conexão não está aberta.
Não é possível alterar o banco de dados.
Exemplos
O exemplo a seguir cria um OdbcConnection e altera o banco de dados atual.
private static void CreateOdbcConnection()
{
string connectionString = "Driver={SQL Native Client};Server=(local);Trusted_Connection=Yes;Database=AdventureWorks;";
using (OdbcConnection connection = new OdbcConnection(connectionString))
{
connection.Open();
Console.WriteLine("ServerVersion: " + connection.ServerVersion
+ "\nDatabase: " + connection.Database);
connection.ChangeDatabase("master");
Console.WriteLine("ServerVersion: " + connection.ServerVersion
+ "\nDatabase: " + connection.Database);
Console.ReadLine();
}
}
Private Sub CreateOdbcConnection()
Dim connectionString As String = _
"Driver={SQL Native Client};Server=(local);Trusted_Connection=Yes;Database=AdventureWorks;"
Using connection As New OdbcConnection(connectionString)
With connection
.Open()
Console.WriteLine("ServerVersion: " & .ServerVersion _
& vbCrLf + "Database: " & .Database)
.ChangeDatabase("master")
Console.WriteLine("ServerVersion: " & .ServerVersion _
& vbCrLf + "Database: " & .Database)
Console.ReadLine()
End With
End Using
End Sub
Comentários
O value
parâmetro deve conter um nome de banco de dados válido e não pode conter um valor nulo, uma cadeia de caracteres vazia (""), ou uma cadeia de caracteres com apenas caracteres em branco.