SqlConnectionStringBuilder.DataSource Właściwość

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Pobiera lub ustawia nazwę lub adres sieciowy wystąpienia SQL Server do nawiązania połączenia.

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

Wartość właściwości

String

Wartość DataSource właściwości lub String.Empty jeśli żadna z nich nie została dostarczona.

Wyjątki

ArgumentNullException

Aby ustawić wartość null, użyj polecenia Value.

Przykłady

W poniższym przykładzie pokazano, że SqlConnectionStringBuilder klasa konwertuje synonimy dla klucza parametrów połączenia "Źródło danych" na dobrze znany klucz:

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

Uwagi

Ta właściwość odpowiada kluczom "Źródło danych", "serwer", "address", "addr" i "adres sieciowy" w parametrach połączenia. Niezależnie od tego, które z tych wartości zostały podane w podanych parametrach połączenia, parametry połączenia utworzone przez program SqlConnectionStringBuilder będą używać dobrze znanego klucza "Źródło danych".

Numer portu można określić po nazwie serwera: server=tcp:servername, portnumber.

Podczas określania wystąpienia lokalnego należy zawsze używać (lokalne). Aby wymusić protokół, dodaj jeden z następujących prefiksów:np:(local), tcp:(local), lpc:(local)

Możesz również nawiązać połączenie z bazą danych LocalDB w następujący sposób: server=(localdb)\\myInstance. Aby uzyskać więcej informacji na temat bazy danych LocalDB, zobacz SqlClient Support for LocalDB (Obsługa klienta sql dla bazy danych LocalDB). Źródło danych musi używać formatu TCP lub formatu nazwanych potoków. Format TCP jest następujący:

• tcp:<nazwa hosta\<nazwa> wystąpienia>
• tcp:<nazwa> hosta,< numer portu TCP/IP>

Format TCP musi zaczynać się od prefiksu "tcp:" i następuje wystąpienie bazy danych określone przez nazwę hosta i nazwę wystąpienia. Ten format nie ma zastosowania podczas nawiązywania połączenia z usługą Azure SQL Database. Protokół TCP jest automatycznie wybierany dla połączeń z usługą Azure SQL Database, gdy nie określono żadnego protokołu.

Nazwa hosta musi być określona na jeden z następujących sposobów:

• NetBIOSName
• IPv4Address
• IPv6Address

Nazwa wystąpienia służy do rozpoznawania określonego numeru portu TCP/IP, na którym jest hostowane wystąpienie bazy danych. Alternatywnie można również określić numer portu TCP/IP bezpośrednio. Jeśli nazwa wystąpienia i numer portu nie są obecne, zostanie użyte domyślne wystąpienie bazy danych.

Format nazwanych potoków jest następujący:

• np:\\<nazwa> hosta\nazwa potoku\<potoku>

Format nazwanych potoków MUSI zaczynać się od prefiksu "np:" i następuje nazwa nazwanego potoku.

Nazwa hosta musi być określona na jeden z następujących sposobów:

• NetBIOSName
• IPv4Address
• IPv6Address

Nazwa potoku służy do identyfikowania wystąpienia bazy danych, z którym będzie się łączyć aplikacja .NET.

Jeśli określono wartość klucza sieciowego , prefiksy "tcp:" i "np:" nie powinny być określone. Uwaga: Możesz wymusić użycie protokołu TCP zamiast pamięci udostępnionej przez prefiks tcp: do nazwy serwera w parametrach połączenia lub przy użyciu hosta lokalnego.