SqlConnection.ChangeDatabase(String) Méthode

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.dll

Modifie la base de données active pour une base de données ouverte SqlConnection.

public:
 virtual void ChangeDatabase(System::String ^ database);
public:
 override void ChangeDatabase(System::String ^ database);
public void ChangeDatabase(string database);
public override void ChangeDatabase(string database);
abstract member ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
Public Sub ChangeDatabase (database As String)
Public Overrides Sub ChangeDatabase (database As String)

Paramètres

database
String

Nom de la base de données à utiliser au lieu de la base de données active.

Implémente

ChangeDatabase(String)

Exceptions

ArgumentException

Le nom de la base de données n’est pas valide.

InvalidOperationException

La connexion n’est pas ouverte.

SqlException

Impossible de modifier la base de données.

Exemples

L’exemple suivant crée un SqlConnection élément et affiche certaines de ses propriétés en lecture seule.

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

Remarques

La valeur fournie dans le database paramètre doit être un nom de base de données valide. Le database paramètre ne peut pas contenir de valeur Null, d’une chaîne vide ou d’une chaîne avec uniquement des caractères vides.

S’applique à

Voir aussi