Поделиться через


SqlConnectionStringBuilder.DataSource Свойство

Определение

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

public:
 property System::String ^ DataSource { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlConnectionStringBuilder+SqlDataSourceConverter))]
public string DataSource { get; set; }
public string DataSource { get; set; }
[<System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlConnectionStringBuilder+SqlDataSourceConverter))>]
member this.DataSource : string with get, set
member this.DataSource : string with get, set
Public Property DataSource As String

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

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

Атрибуты

Исключения

Чтобы задать значение 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.

Применяется к