SqlConnectionStringBuilder.DataSource Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Ruft den Namen oder die Netzwerkadresse der Instanz von SQL Server ab, mit der eine Verbindung hergestellt werden soll, oder legt einen Namen bzw. eine Adresse fest.

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

public string DataSource { get; set; }

member this.DataSource : string with get, set

Public Property DataSource As String

Eigenschaftswert

String

Der Wert der DataSource-Eigenschaft bzw. String.Empty, wenn kein Wert angegeben wurde.

Ausnahmen

ArgumentNullException

Verwenden Sie Value, um den Wert auf NULL festzulegen.

Beispiele

Im folgenden Beispiel wird gezeigt, dass die SqlConnectionStringBuilder-Klasse Synonyme für den Verbindungszeichenfolgenschlüssel "Data Source" in einen bekannten Schlüssel konvertiert:

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(
            "Network Address=(local);Integrated Security=SSPI;" +
            "Initial Catalog=AdventureWorks");

        // Display the connection string, which should now 
        // contain the "Data Source" key, as opposed to the 
        // supplied "Network Address".
        Console.WriteLine(builder.ConnectionString);

        // Retrieve the DataSource property.
        Console.WriteLine("DataSource = " + builder.DataSource);

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

Hinweise

Diese Eigenschaft entspricht den Schlüsseln "Data Source", "server", "address", "addr" und "network address" in der Verbindungszeichenfolge. Unabhängig davon, welcher dieser Werte in der angegebenen Verbindungszeichenfolge angegeben wurde, verwendet die von erstellte SqlConnectionStringBuilder Verbindungszeichenfolge den bekannten Schlüssel "Datenquelle".

Die Portnummer kann nach dem Servernamen angegeben werden: server=tcp:servername, portnumber.

Verwenden Sie beim Angeben eines lokalen instance immer (lokal). Um ein Protokoll zu erzwingen, fügen Sie eines der folgenden Präfixe hinzu:np:(local), tcp:(local), lpc:(local).

Sie können auch eine Verbindung mit einer LocalDB-Datenbank wie folgt herstellen: server=(localdb)\\myInstance. Weitere Informationen zu LocalDB finden Sie unter SqlClient-Unterstützung für LocalDB. Die Datenquelle muss das TCP-Format oder das Named Pipes-Format verwenden. Das TCP-Format lautet wie folgt:

• tcp:<hostname>\<instance name>
• tcp:<Hostname,TCP<>/IP-Portnummer>

Das TCP-Format muss mit dem Präfix "tcp:" beginnen, gefolgt von der datenbank-instance, wie durch einen Hostnamen und einen instance Namen angegeben. Dieses Format gilt nicht, wenn eine Verbindung mit Azure SQL-Datenbank hergestellt wird. TCP wird automatisch für Verbindungen mit Azure SQL Datenbank ausgewählt, wenn kein Protokoll angegeben wird.

Der Hostname MUSS auf eine der folgenden Arten angegeben werden:

• NetBIOSName
• IPv4-Adresse
• IPv6-Adresse

Der instance Name wird verwendet, um eine bestimmte TCP/IP-Portnummer aufzulösen, auf der eine Datenbank instance gehostet wird. Alternativ ist auch die direkte Angabe einer TCP/IP-Portnummer zulässig. Wenn instance Name und die Portnummer nicht vorhanden sind, wird die Standarddatenbank instance verwendet.

Das Named Pipes-Format sieht wie folgt aus:

• np:\\<hostname>\pipe\<pipe name>

Das Named Pipes-Format MUSS mit dem Präfix "np:" beginnen, gefolgt von einem benannten Pipenamen.

Der Hostname MUSS auf eine der folgenden Arten angegeben werden:

• NetBIOSName
• IPv4-Adresse
• IPv6-Adresse

Der Pipename wird verwendet, um die Datenbank instance zu identifizieren, mit der die .NET-Anwendung eine Verbindung herstellt.

Wenn der Wert des Netzwerkschlüssels angegeben wird, sollten die Präfixe "tcp:" und "np:" nicht angegeben werden. Hinweis: Sie können die Verwendung von TCP anstelle von freigegebenem Arbeitsspeicher erzwingen, indem Sie tcp: dem Servernamen in der Verbindungszeichenfolge vorangestellt oder localhost verwenden.