SqlConnection.ChangeDatabase(String) Metoda

Definicja

Namespace:

System.Data.SqlClient

Montaż:

System.Data.dll

Zmienia bieżącą bazę danych dla otwartego SqlConnectionpliku .

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)

Parametry

database

String

Nazwa bazy danych do użycia zamiast bieżącej bazy danych.

Wyjątki

ArgumentException

Nazwa bazy danych jest nieprawidłowa.

InvalidOperationException

Połączenie nie jest otwarte.

SqlException

Nie można zmienić bazy danych.

Przykłady

Poniższy przykład tworzy obiekt SqlConnection i wyświetla niektóre z jego właściwości tylko do odczytu.

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

Uwagi

Wartość podana w parametrze database musi być prawidłową nazwą bazy danych. Parametr database nie może zawierać wartości null, pustego ciągu ani ciągu z pustymi znakami.

Zobacz także

• Nawiązywanie połączenia ze źródłem danych w ADO.NET
• SQL Server i ADO.NET
• Omówienie ADO.NET