SqlConnectionStringBuilder.TransparentNetworkIPResolution Свойство

Определение

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

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v7.1.0

Внимание!

TransparentNetworkIPResolution has been deprecated and is only supported on .NET Framework. Use MultiSubnetFailover instead.

В .NET Framework, если задано trueзначение этого ключа, драйвер выполняет несколько округлений подключения по IP-адресам, разрешаемых DNS, с постепенно большим временем ожидания для каждой попытки и 500 мс минимального значения при попытке последовательного режима, пока подключение не завершится или не будет достигнуто общее Connect Timeout значение.

public:
 property bool TransparentNetworkIPResolution { bool get(); void set(bool value); };

[System.Obsolete("TransparentNetworkIPResolution has been deprecated and is only supported on .NET Framework. Use MultiSubnetFailover instead.")]
public bool TransparentNetworkIPResolution { get; set; }

[<System.Obsolete("TransparentNetworkIPResolution has been deprecated and is only supported on .NET Framework. Use MultiSubnetFailover instead.")>]
member this.TransparentNetworkIPResolution : bool with get, set

Public Property TransparentNetworkIPResolution As Boolean

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

Boolean

Булевое значение.

Атрибуты

ObsoleteAttribute

Комментарии

Это свойство устарело. Вместо этого используйте MultiSubnetFailover.

Multi Subnet Failover Если для ключа задано trueзначение , Transparent Network IP Resolution игнорируется.

Failover Partner Если задан ключ, Transparent Network IP Resolution игнорируется.

В .NET Framework, если TransparentNetworkIPResolution он не указан в строка подключения, драйвер автоматически отключает TNIR, если источник данных является конечной точкой Azure SQL (.database.windows.net, , или.database.fabric.microsoft.com), если Authentication для ключа задан любой метод Microsoft Entra ID (Active Directory Password, .database.usgovcloudapi.net.database.cloudapi.de.database.chinacloudapi.cn, Active Directory Service PrincipalActive Directory InteractiveActive Directory IntegratedActive Directory Managed IdentityActive Directory MSIActive Directory Device Code FlowActive Directory Defaultили)Active Directory Workload Identity), или если AccessTokenAccessTokenCallback для объекта или свойства задано SqlConnectionзначение . Для этих автоматических условий явное TransparentNetworkIPResolution значение проходит автоматическое поведение: True включает TNIR и False отключает TNIR безоговорочно. Чтобы восстановить автоматическое поведение, удалите ключевое слово из строка подключения.

В .NET (Core, .NET 5+) TransparentNetworkIPResolution не является распознаваемым ключевым словом строки подключения. При анализе строка подключения драйвер вызывает его ArgumentException (с любым значением).

В .NET Framework значение этого ключа должно быть true, falseyesили no.

Значение yes обрабатывается так же, как и значение true. Значение no обрабатывается так же, как и значение false.