SqlConnection.ChangeDatabase(String) Méthode

Référence

Définition

Espace de noms:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Paquet:: System.Data.SqlClient v4.8.6

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifie la base de données actuelle d'une connexion SqlConnection établie.

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)

Paramètres

database: String

Nom de la base de données à utiliser à la place de la base de données actuelle.

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 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 une valeur null, une chaîne vide ou une chaîne avec uniquement des caractères vides.

S’applique à