OdbcConnection.ChangeDatabase(String) Method
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.
Changes the current database associated with an open OdbcConnection.
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)
- value
- String
The database name.
The database name is not valid.
The connection is not open.
Cannot change the database.
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
The value
parameter must contain a valid database name, and cannot contain a null value, an empty string (""), or a string with only blank characters.
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) |
.NET feedback
.NET is an open source project. Select a link to provide feedback: