OdbcConnection.Database Property
Definition
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
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.