SqlConnection.ChangeDatabase(String) Methode

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Paket:: System.Data.SqlClient v4.8.6

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

ChangeDatabase(String)

Ausnahmen

ArgumentException

Der Datenbankname ist ungültig.

InvalidOperationException

Die Verbindung ist nicht geöffnet.

SqlException

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.

Gilt für: