SqlConnection.ChangeDatabase(String) Methode

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Ändert die aktuelle Datenbank für eine offene SqlConnection.

public:
 override void ChangeDatabase(System::String ^ database);

public override void ChangeDatabase (string database);

override this.ChangeDatabase : string -> unit

Public Overrides Sub ChangeDatabase (database As String)

Parameter

database

String

Der Name der Datenbank, die anstelle der aktuellen Datenbank verwendet werden soll.

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.

using Microsoft.Data.SqlClient;

class Program1
{
    static void Main()
    {
        string s = GetConnectionString();

        ChangeSqlDatabase(s);
        Console.ReadLine();
    }

    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);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

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.