SqlConnection.ChangeDatabase(String) Метод

Определение

Пространство имен:
System.Data.SqlClient
Сборка:
System.Data.SqlClient.dll
Сборка:
System.Data.dll
Исходный код:
System.Data.SqlClient.notsupported.cs

Изменяет текущую базу данных для открытой 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)

Параметры

database
String

Имя базы данных, используемой вместо текущей базы данных.

Реализации

ChangeDatabase(String)

Исключения

ArgumentException

Недопустимое имя базы данных.

InvalidOperationException

Подключение не открыто.

SqlException

Не удается изменить базу данных.

Примеры

В следующем примере создается и SqlConnection отображается некоторые из его свойств, доступных только для чтения.

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

Комментарии

Значение, указанное в параметре database , должно быть допустимым именем базы данных. Параметр database не может содержать значение NULL, пустую строку или строку только пустыми символами.

Применяется к

См. также раздел