SqlConnection.ChangeDatabase(String) Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

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

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)

Paramètres

database

String

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

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.

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

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.