SqlConnection.ChangeDatabase(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Altera o banco de dados atual para um SqlConnection aberto.
public:
override void ChangeDatabase(System::String ^ database);public override void ChangeDatabase (string database);override this.ChangeDatabase : string -> unitPublic Overrides 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.
Exceções
O nome do banco de dados não é válido.
A conexão não está aberta.
Não é possível alterar o banco de dados.
Exemplos
O exemplo a seguir cria um SqlConnection e exibe algumas de suas propriedades somente leitura.
using Microsoft.Data.SqlClient;
class Program1
{
static void Main()
{
string s = GetConnectionString();
ChangeSqlDatabase(s);
Console.ReadLine();
}
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);
}
}
static private string GetConnectionString()
{
// To avoid storing the connection string in your code,
// you can retrieve it from a configuration file, using the
// System.Configuration.ConfigurationSettings.AppSettings property
return "Data Source=(local);Initial Catalog=AdventureWorks;"
+ "Integrated Security=SSPI;";
}
}
Comentários
O valor fornecido no database parâmetro deve ser um nome de banco de dados válido. O database parâmetro não pode conter um valor nulo, uma cadeia de caracteres vazia ou uma cadeia de caracteres com apenas caracteres em branco.