Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

SqlConnectionStringBuilder.InitialCatalog-Eigenschaft

.NET Framework 4

Ruft den Namen der Datenbank ab, die der Verbindung zugeordnet ist, oder legt einen Namen fest.

Namespace:  System.Data.SqlClient
Assembly:  System.Data (in System.Data.dll)
C#
C++
F#
VB
Kopieren 
public string InitialCatalog { get; set; }

Eigenschaftswert

Typ: System.String
Der Wert der InitialCatalog-Eigenschaft bzw. String.Empty, wenn kein Wert angegeben wurde.

Diese Eigenschaft entspricht den Schlüsseln "Initial Catalog" und "database" in der Verbindungszeichenfolge.

Wenn der Wert nicht festgelegt wurde und der Entwickler versucht, die Eigenschaft abzurufen, wird der Wert String.Empty zurückgegeben.

Im folgenden Beispiel wird eine einfache Verbindungszeichenfolge erstellt und dann der Datenbankname mithilfe der SqlConnectionStringBuilder-Klasse in die Verbindungszeichenfolge eingefügt. Im Code wird zunächst der Inhalt der InitialCatalog-Eigenschaft angezeigt, um zu überprüfen, ob die Klasse das Synonym ("Database") in den entsprechenden Eigenschaftswert konvertieren konnte.

C#
VB
Kopieren 

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

.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ