SqlConnection.ChangeDatabase(String) SqlConnection.ChangeDatabase(String) SqlConnection.ChangeDatabase(String) SqlConnection.ChangeDatabase(String) Method

Определение

Осуществляет смену текущей базы данных для открытого соединения SqlConnection.Changes the current database for an open SqlConnection.

public:
 virtual void ChangeDatabase(System::String ^ database);
public void ChangeDatabase (string database);
abstract member ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
Public Sub ChangeDatabase (database As String)

Параметры

database
String String String String

Имя базы данных, предназначенной для использования вместо текущей базы данных.The name of the database to use instead of the current database.

Реализации

Исключения

Недопустимое имя базы данных.The database name is not valid.

Соединение не открыто.The connection is not open.

Невозможно изменить базу данных.Cannot change the database.

Примеры

В следующем примере создается SqlConnection и отображаются некоторые из его свойств только для чтения.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

Комментарии

Значение, указываемое в database параметре, должно быть допустимым именем базы данных.The value supplied in the database parameter must be a valid database name. database Параметр не может содержать значение null, пустую строку или строку только с пустыми символами.The database parameter cannot contain a null value, an empty string, or a string with only blank characters.

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

Дополнительно