SqlConnectionStringBuilder.InitialCatalog Propriété

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

[System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlConnectionStringBuilder+SqlInitialCatalogConverter))]
public string InitialCatalog { get; set; }

public string InitialCatalog { get; set; }

[<System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlConnectionStringBuilder+SqlInitialCatalogConverter))>]
member this.InitialCatalog : string with get, set

member this.InitialCatalog : string with get, set

Public Property InitialCatalog As String

Valeur de propriété

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

Attributs

TypeConverterAttribute

Exceptions

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.

S’applique à