SqlConnection.ChangeDatabase(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ändert die aktuelle Datenbank für eine offene SqlConnection.
public:
override void ChangeDatabase(System::String ^ database);
public:
virtual void ChangeDatabase(System::String ^ database);
public override void ChangeDatabase (string database);
public void ChangeDatabase (string database);
override this.ChangeDatabase : string -> unit
abstract member ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
Public Overrides Sub ChangeDatabase (database As String)
Public Sub ChangeDatabase (database As String)
Parameter
- database
- String
Der Name der Datenbank, die anstelle der aktuellen Datenbank verwendet werden soll.
Implementiert
Ausnahmen
Der Datenbankname ist ungültig.
Die Verbindung ist nicht geöffnet.
Die Datenbank kann nicht geändert werden.
Beispiele
Im folgenden Beispiel wird ein SqlConnection erstellt und einige der schreibgeschützten Eigenschaften angezeigt.
private static void ChangeSqlDatabase(string connectionString)
{
// Assumes connectionString represents a valid connection string
// to the AdventureWorks sample database.
using (SqlConnection connection = new SqlConnection(connectionString))
{
connection.Open();
Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
Console.WriteLine("Database: {0}", connection.Database);
connection.ChangeDatabase("Northwind");
Console.WriteLine("Database: {0}", connection.Database);
}
}
Private Sub ChangeSqlDatabase(ByVal connectionString As String)
' Assumes connectionString represents a valid connection string
' to the AdventureWorks sample database.
Using connection As New SqlConnection(connectionString)
connection.Open()
Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
Console.WriteLine("Database: {0}", connection.Database)
connection.ChangeDatabase("Northwind")
Console.WriteLine("Database: {0}", connection.Database)
End Using
End Sub
Hinweise
Der im database
Parameter angegebene Wert muss ein gültiger Datenbankname sein. Der database
Parameter darf keinen NULL-Wert, eine leere Zeichenfolge oder eine Zeichenfolge mit nur leeren Zeichen enthalten.