SqlConnection.ChangeDatabase(String) Método

Definición

Cambia la base de datos actual de una conexión SqlConnection abierta.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)

Parámetros

database
String

Nombre de la base de datos que se utiliza en lugar de la actual.The name of the database to use instead of the current database.

Implementaciones

Excepciones

El nombre de la base de datos no es válido.The database name is not valid.

La conexión no está abierta.The connection is not open.

No se puede modificar la base de datos.Cannot change the database.

Ejemplos

En el ejemplo siguiente se crea una SqlConnection y se muestran algunas de sus propiedades de solo lectura.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

Comentarios

El valor proporcionado en el parámetro database debe ser un nombre de base de datos válido.The value supplied in the database parameter must be a valid database name. El parámetro database no puede contener un valor null, una cadena vacía o una cadena con solo caracteres en blanco.The database parameter cannot contain a null value, an empty string, or a string with only blank characters.

Se aplica a

Consulte también: