OdbcConnection.Database Property

Reference

Definition

Namespace:: System.Data.Odbc

Assembly:: System.Data.Odbc.dll

Assembly:: System.Data.dll

Package:: System.Data.Odbc v9.0.2

Source:: OdbcConnection.cs

Source:: OdbcConnection.cs

Source:: OdbcConnection.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Property Value

String

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

Implements

Database

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

Product	Versions
.NET	8 (package-provided), 9 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard	2.0 (package-provided)

Share via