SqlConnection.ChangeDatabase(String) Método
Definição
Altera o banco de dados atual para um SqlConnection aberto.Changes the current database for an open 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)
Parâmetros
- database
- String
O nome do banco de dados a ser usado em vez do banco de dados atual.The name of the database to use instead of the current database.
Implementações
Exceções
O nome do banco de dados não é válido.The database name is not valid.
A conexão não está aberta.The connection is not open.
Não é possível alterar o banco de dados.Cannot change the database.
Exemplos
O exemplo a seguir cria um SqlConnection e exibe algumas de suas propriedades somente leitura.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
Comentários
O valor fornecido no database parâmetro deve ser um nome de banco de dados válido.The value supplied in the database parameter must be a valid database name. O database parâmetro não pode conter um valor nulo, uma cadeia de caracteres vazia ou uma cadeia somente com caracteres em branco.The database parameter cannot contain a null value, an empty string, or a string with only blank characters.