SqlConnection.ChangeDatabase(String) Methode

Definition

Ändert die aktuelle Datenbank für eine offene SqlConnection.Changes the current database for an open 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.The name of the database to use instead of the current database.

Implementiert

Ausnahmen

Der Datenbankname ist ungültig.The database name is not valid.

Die Verbindung ist nicht geöffnet.The connection is not open.

Die Datenbank kann nicht geändert werden.Cannot change the database.

Beispiele

Im folgenden Beispiel wird eine SqlConnection erstellt und einige der schreibgeschützten Eigenschaften angezeigt.The following example creates a SqlConnection and displays some of its read-only properties.

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.The value supplied in the database parameter must be a valid database name. Der database-Parameter darf keinen NULL-Wert, keine leere Zeichenfolge oder eine Zeichenfolge enthalten, die nur Leerzeichen enthält.The database parameter cannot contain a null value, an empty string, or a string with only blank characters.

Gilt für:

Siehe auch