OdbcConnection.Database Property

Definition

Gets the name of the current database or the database to be used after a connection is opened.

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

Property Value

The name of the current database. The default value is an empty string ("") until the connection is opened.

Implements

Examples

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

Remarks

At first, the Database property is set in the connection string. The Database property can be updated by using the ChangeDatabase method. 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.

Retrieving the Database property is equivalent to calling the ODBC function SQLGetInfo with the Attribute parameter set to SQL_ATTR_CURRENT_CATALOG.

Applies to

See also