OdbcConnection.ChangeDatabase(String) Método

  • Referência

Definição

Namespace:
System.Data.Odbc
Assembly:
System.Data.Odbc.dll
Assembly:
System.Data.dll
Pacote:
System.Data.Odbc v8.0.1
Pacote:
System.Data.Odbc v9.0.0-rc.2.24473.5
Origem:
OdbcConnection.cs
Origem:
OdbcConnection.cs

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

ChangeDatabase(String)

Exceções

ArgumentException

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

InvalidOperationException

A conexão não está aberta.

OdbcException

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.

Aplica-se a

Confira também