SqlConnectionStringBuilder.InitialCatalog Propiedad

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Obtiene o establece el nombre de la base de datos asociada a la conexión.

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

Valor de propiedad

String

Valor de la propiedad InitialCatalog o String.Empty si no se ha proporcionado ninguno.

Excepciones

ArgumentNullException

Para establecer el valor en null, use Value.

Ejemplos

En el ejemplo siguiente se crea una cadena de conexión simple y, a continuación, se utiliza la clase SqlConnectionStringBuilder para agregar el nombre de la base de datos a la cadena de conexión. El código muestra el contenido de la propiedad InitialCatalog simplemente para verificar que la clase pudo convertir el sinónimo ("Database") al valor de propiedad apropiado.

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

Comentarios

Esta propiedad se corresponde con las claves "Initial Catalog" y "database" dentro de la cadena de conexión .

El nombre de la base de datos puede tener 128 caracteres o menos.