SqlConnectionStringBuilder.InitialCatalog Proprietà

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

Ottiene o imposta il nome del database associato alla connessione.

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

Valore della proprietà

String

Valore della proprietà InitialCatalog o String.Empty se non è stato fornito alcun valore.

Eccezioni

ArgumentNullException

Per impostare il valore su Null, usare Value.

Esempio

Nel seguente esempio viene creata una stringa di connessione semplice e quindi viene utilizzata la classe SqlConnectionStringBuilder per aggiungere il nome del database alla stringa di connessione. Nel codice viene visualizzato il contenuto della proprietà InitialCatalog per verificare che la classe era in grado di eseguire la conversione dal sinonimo ("Database") al valore della proprietà appropriata.

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();
    }
}

Commenti

Questa proprietà corrisponde alle chiavi "Initial Catalog" e "database" all'interno della stringa di connessione.

Il nome del database può essere di 128 caratteri o meno.