SqlConnection.ChangeDatabase(String) Metoda

Reference

Definice

Obor názvů:: System.Data.SqlClient

Sestavení:: System.Data.SqlClient.dll

Sestavení:: System.Data.dll

Balíček:: System.Data.SqlClient v4.8.6

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Změní aktuální databázi otevřeného objektu 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)

Parametry

database: String

Název databáze, která se má použít místo aktuální databáze.

Implementuje

ChangeDatabase(String)

Výjimky

ArgumentException

Název databáze není platný.

InvalidOperationException

Připojení není otevřené.

SqlException

Databázi nelze změnit.

Příklady

Následující příklad vytvoří SqlConnection a zobrazí některé jeho vlastnosti jen pro čtení.

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

Poznámky

Hodnota zadaná v parametru database musí být platný název databáze. Parametr database nesmí obsahovat hodnotu null, prázdný řetězec ani řetězec pouze s prázdnými znaky.

Platí pro