SqlConnection.ChangeDatabase(String) Método

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Cambia la base de datos actual de una conexión SqlConnection abierta.

public:
 override void ChangeDatabase(System::String ^ database);

public override void ChangeDatabase (string database);

override this.ChangeDatabase : string -> unit

Public Overrides Sub ChangeDatabase (database As String)

Parámetros

database

String

Nombre de la base de datos que se utiliza en lugar de la actual.

Excepciones

ArgumentException

El nombre de la base de datos no es válido.

InvalidOperationException

La conexión no está abierta.

SqlException

No se puede modificar la base de datos.

Ejemplos

En el ejemplo siguiente se crea un SqlConnection objeto y se muestran algunas de sus propiedades de solo lectura.

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;";
    }
}

Comentarios

El valor proporcionado en el database parámetro debe ser un nombre de base de datos válido. El database parámetro no puede contener un valor NULL, una cadena vacía o una cadena con solo caracteres en blanco.