SqlConnectionStringBuilder.DataSource Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Získá nebo nastaví název nebo síťovou adresu instance SQL Server pro připojení.

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

Hodnota vlastnosti

String

Hodnota DataSource vlastnosti nebo String.Empty pokud nebyla zadána žádná.

Výjimky

ArgumentNullException

Pokud chcete nastavit hodnotu na hodnotu null, použijte Value.

Příklady

Následující příklad ukazuje, že SqlConnectionStringBuilder třída převádí synonyma pro klíč připojovacího řetězce "Zdroj dat" na dobře známý klíč:

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

Poznámky

Tato vlastnost odpovídá klíčům "Zdroj dat", "server", "address", "addr" a "network address" v rámci připojovacího řetězce. Bez ohledu na to, která z těchto hodnot byla zadána v zadaném připojovacím řetězci, bude připojovací řetězec vytvořený nástrojem SqlConnectionStringBuilder používat dobře známý klíč "Zdroj dat".

Číslo portu lze zadat za názvem serveru: server=tcp:servername, portnumber.

Při zadávání místní instance vždy použijte (místní). Pokud chcete vynutit protokol, přidejte jednu z následujících předpon:np:(local), tcp:(local), lpc:(local).

K databázi LocalDB se můžete také připojit následujícím způsobem: server=(localdb)\\myInstance. Další informace o LocalDB najdete v tématu Podpora SqlClient pro LocalDB. Zdroj dat musí používat formát TCP nebo pojmenované kanály. Formát TCP je následující:

• tcp:<název> hostitele\<název instance>
• tcp:<název> hostitele,< číslo portu TCP/IP>

Formát TCP musí začínat předponou "tcp:" a za ním následuje instance databáze podle názvu hostitele a názvu instance. Tento formát se nedá použít při připojování k Azure SQL Database. Pro připojení k databázi Azure SQL je automaticky vybrán protokol TCP, pokud není zadaný žádný protokol.

Název hostitele MUSÍ být zadán jedním z následujících způsobů:

• NetBIOSName
• IPv4Address
• IPv6Address

Název instance se používá k překladu na konkrétní číslo portu TCP/IP, na kterém je hostovaná instance databáze. Případně je možné zadat číslo portu TCP/IP přímo. Pokud název instance ani číslo portu nejsou k dispozici, použije se výchozí instance databáze.

Formát pojmenovaných kanálů je následující:

• np:\\<název> hostitele\pipe\<název kanálu>

Formát Pojmenované kanály MUSÍ začínat předponou np:, za kterou následuje název pojmenovaného kanálu.

Název hostitele MUSÍ být zadán jedním z následujících způsobů:

• NetBIOSName
• IPv4Address
• IPv6Address

Název kanálu slouží k identifikaci instance databáze, ke které se bude aplikace .NET připojovat.

Pokud je zadána hodnota síťového klíče, neměly by být zadány předpony "tcp:" a "np:". Poznámka: Místo sdílené paměti můžete vynutit použití protokolu TCP, a to buď zadáním předpony tcp: k názvu serveru v připojovacím řetězci, nebo pomocí localhost.