OdbcConnection.Database Propriedade

Definição

Obtém o nome do banco de dados atual ou o banco de dados a ser usado após uma conexão ser aberta.Gets the name of the current database or the database to be used after a connection is opened.

public:
 virtual property System::String ^ Database { System::String ^ get(); };
public:
 property System::String ^ Database { System::String ^ get(); };
public override string Database { get; }
public string Database { get; }
member this.Database : string
Public Overrides ReadOnly Property Database As String
Public ReadOnly Property Database As String

Valor da propriedade

String

O nome do banco de dados atual.The name of the current database. O valor padrão é uma cadeia de caracteres vazia ("") até que a conexão seja aberta.The default value is an empty string ("") until the connection is opened.

Implementações

Exemplos

O exemplo a seguir cria um OdbcConnection e altera o banco de dados atual.The following example creates an OdbcConnection and changes the current database.

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

Primeiro, a Database propriedade é definida na cadeia de conexão.At first, the Database property is set in the connection string. A Database propriedade pode ser atualizada usando o ChangeDatabase método.The Database property can be updated by using the ChangeDatabase method. Se você alterar o banco de dados atual usando uma instrução SQL ou o ChangeDatabase método, uma mensagem informativa será enviada e a propriedade será atualizada.If you change the current database using an SQL statement or the ChangeDatabase method, an informational message is sent and then the property is updated.

Recuperar a Database propriedade é equivalente a chamar a função ODBC SQLGetInfo com o Attribute parâmetro definido como SQL_ATTR_CURRENT_CATALOG.Retrieving the Database property is equivalent to calling the ODBC function SQLGetInfo with the Attribute parameter set to SQL_ATTR_CURRENT_CATALOG.

Aplica-se a