SqlConnectionStringBuilder.InitialCatalog Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Obtient ou définit le nom de la base de données associée à la connexion.

public:
 property System::String ^ InitialCatalog { System::String ^ get(); void set(System::String ^ value); };

public string InitialCatalog { get; set; }

member this.InitialCatalog : string with get, set

Public Property InitialCatalog As String

Valeur de propriété

String

Valeur de la propriété InitialCatalog, ou String.Empty si aucune valeur n’a été fournie.

Exceptions

ArgumentNullException

Pour définir la valeur sur null, utilisez Value.

Exemples

L'exemple suivant crée une chaîne de connexion simple, puis utilise la classe SqlConnectionStringBuilder pour ajouter le nom de la base de données à la chaîne de connexion. Le code affiche le contenu de la propriété InitialCatalog, pour vérifier simplement que la classe était capable de convertir le synonyme (« Database ») vers la valeur de propriété appropriée.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString = "Data Source=(local);" +
                "Integrated Security=true";

            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);

            // Normally, you could simply set the InitialCatalog
            // property of the SqlConnectionStringBuilder object. This
            // example uses the default Item property (the C# indexer)
            // and the "Database" string, simply to demonstrate that
            // setting the value in this way results in the same
            // connection string:
            builder["Database"] = "AdventureWorks";
            Console.WriteLine("builder.InitialCatalog = "
                + builder.InitialCatalog);
            Console.WriteLine("Modified: " + builder.ConnectionString);

            using (SqlConnection connection =
                new SqlConnection(builder.ConnectionString))
            {
                connection.Open();
                // Now use the open connection.
                Console.WriteLine("Database = " + connection.Database);
            }

        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }

        Console.WriteLine("Press any key to finish.");
        Console.ReadLine();
    }
}

Remarques

Cette propriété correspond aux clés « Initial Catalog » et « database » dans la chaîne de connexion.

Le nom de la base de données peut comporter 128 caractères ou moins.