SqlConnectionStringBuilder.DataSource Свойство

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Возвращает или задает имя или сетевой адрес экземпляра SQL Server, с которым устанавливается соединение.

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

Значение свойства

String

Значение свойства DataSource или значение String.Empty, если значение не указано.

Исключения

ArgumentNullException

Чтобы задать значение NULL, используйте Value.

Примеры

В следующем примере показывается, как класс SqlConnectionStringBuilder преобразует синонимы для ключа «Data Source» строки подключения в хорошо известный ключ:

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

Комментарии

Это свойство соответствует ключам «Data Source», «server», «address», «addr» и «network address» в строке подключения. Независимо от того, какое из этих значений было предоставлено в предоставленной строке подключения, строка подключения, созданная с помощью SqlConnectionStringBuilder , будет использовать известный ключ "Источник данных".

Номер порта можно указать после имени сервера: server=tcp:servername, portnumber.

При указании локального экземпляра всегда используйте (local). Чтобы принудительно применить протокол, добавьте один из следующих префиксов:np:(local), tcp:(local), lpc:(local) .

Вы также можете подключиться к базе данных LocalDB следующим образом: server=(localdb)\\myInstance. Дополнительные сведения о LocalDB см. в разделе Поддержка SqlClient для LocalDB. Источник данных должен использовать формат TCP или формат именованных каналов. Формат TCP выглядит следующим образом:

• tcp:<имя> узла\<имя экземпляра>
• tcp:<имя> узла,номер< порта TCP/IP>

Формат TCP должен начинаться с префикса "tcp:", за которым следует экземпляр базы данных, как указано в имени узла и имени экземпляра. Этот формат неприменим при подключении к базе данных Azure SQL. Tcp автоматически выбирается для подключений к базе данных Azure SQL, если протокол не указан.

Имя узла должно быть указано одним из следующих способов:

• NetBIOSName
• IPv4-адрес
• IPv6-адрес

Имя экземпляра используется для разрешения в определенный номер порта TCP/IP, на котором размещен экземпляр базы данных. Кроме того, можно указать номер порта TCP/IP напрямую. Если имя экземпляра и номер порта отсутствуют, используется экземпляр базы данных по умолчанию.

Формат именованных каналов выглядит следующим образом:

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

Формат именованных каналов должен начинаться с префикса "np:", за которым следует имя именованного канала.

Имя узла должно быть указано одним из следующих способов:

• NetBIOSName
• IPv4-адрес
• IPv6-адрес

Имя канала используется для идентификации экземпляра базы данных, к которому будет подключаться приложение .NET.

Если указано значение сетевого ключа, не следует указывать префиксы "tcp:" и "np:". Примечание: Вы можете принудительно использовать TCP вместо общей памяти, указав префикс tcp: к имени сервера в строке подключения или с помощью localhost.