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 框架中，當此鍵值設為 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

boolean 值。

屬性

ObsoleteAttribute

備註

這個屬性已過時。 請改用 MultiSubnetFailover。

若 Multi Subnet Failover 鍵值設為 true， Transparent Network IP Resolution 則忽略。

如果 Failover Partner 設定了金鑰，則 Transparent Network IP Resolution 忽略了。

在 .NET Framework 中，若 TransparentNetworkIPResolution 連接字串 未指定，當資料來源為 Azure SQL 端點（.database.windows.net， .database.cloudapi.de.database.chinacloudapi.cn.database.usgovcloudapi.net或 .database.fabric.microsoft.com），且Authentication金鑰設為任意 Microsoft Entra ID 方法（Active Directory Password， Active Directory Service PrincipalActive Directory InteractiveActive Directory IntegratedActive Directory Managed IdentityActive Directory MSIActive Directory Device Code FlowActive Directory Default或 Active Directory Workload Identity ） 時，驅動程式會自動停用 TNIR），或當 AccessToken 或 AccessTokenCallback 屬性被設定在 SqlConnection上時。 對於這些自動條件，明確 TransparentNetworkIPResolution 的值會繞過自動行為： True 啟用 TNIR，並 False 無條件禁用 TNIR。 要恢復自動行為，請從 連接字串 中移除關鍵字。

在 .NET（Core，.NET 5+）中，TransparentNetworkIPResolution沒有被認可的連接字串關鍵字。 設定它（任意值）在驅動程式解析 連接字串 時會拋ArgumentException棄。

在 .NET 框架中，此鍵值必須為 true、 false、 yes或 no。

值 與 yes 值 true視為相同。 值 與 no 值 false視為相同。