SqlConnection.ChangeDatabase(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Осуществляет смену текущей базы данных для открытого соединения 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
Имя базы данных, предназначенной для использования вместо текущей базы данных.
Реализации
Исключения
Недопустимое имя базы данных.
Соединение не открыто.
Невозможно изменить базу данных.
Примеры
В следующем примере создается 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, пустую строку или строку, содержащую только пустые символы.