SqlConnection.ChangeDatabase(String) Método

  • Referencia

Definición

Espacio de nombres:
System.Data.SqlClient
Ensamblado:
System.Data.SqlClient.dll
Ensamblado:
System.Data.dll
Paquete:
System.Data.SqlClient v4.8.6

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

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

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

Implementaciones

ChangeDatabase(String)

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 y SqlConnection se muestran algunas de sus propiedades de solo lectura.

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 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.

Se aplica a

Consulte también