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时，驱动程序会跨 DNS 解析的 IP 地址运行多个连接轮次，每次尝试超时逐渐增大，在顺序模式尝试上至少运行 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在连接字符串中指定，当数据源是Azure SQL终结点（、、.database.cloudapi.de、.database.usgovcloudapi.net.database.chinacloudapi.cn或.database.fabric.microsoft.com）时Authentication，当密钥设置为任何Microsoft Entra ID方法（.database.windows.netActive Directory Password、、Active Directory InteractiveActive Directory IntegratedActive Directory Service Principal、Active Directory Device Code Flow、Active Directory MSIActive Directory Managed Identity、或Active Directory DefaultActive Directory Workload Identity）时，驱动程序会自动禁用 TNIR或在设置属性时AccessTokenAccessTokenCallbackSqlConnection。 对于这些自动条件，显式 TransparentNetworkIPResolution 值会绕过自动行为： True 启用 TNIR，并 False 无条件禁用 TNIR。 要恢复自动行为，请从连接字符串中移除关键词。

在.NET（核心，.NET 5+），TransparentNetworkIPResolution不是可识别的连接字符串关键字。 当驱动程序分析连接字符串时，设置它（具有任何值）将ArgumentException引发。

在 .NET Framework 上，此键的值必须为true、false或yesno。

值 yes 被视为与值 true相同的值。 值 no 被视为与值 false相同的值。