SqlConnectionStringBuilder.TransparentNetworkIPResolution Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Package:

Microsoft.Data.SqlClient v7.1.0

Attention

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

Sur .NET Framework, lorsque la valeur de cette clé est définietrue, le pilote exécute plusieurs rondes de connexion sur les adresses IP résolues par DNS, avec des délais d’expiration progressivement plus importants par tentative et un minimum de 500 ms sur la tentative en mode séquentiel, jusqu’à ce qu’une connexion réussisse ou que l’ensemble Connect Timeout soit atteint.

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

Valeur de propriété

Boolean

Valeur booléenne.

Attributs

ObsoleteAttribute

Remarques

Cette propriété est obsolète. Utilisez MultiSubnetFailover à la place.

Si la Multi Subnet Failover clé est définie truesur , Transparent Network IP Resolution est ignorée.

Si la Failover Partner clé est définie, Transparent Network IP Resolution elle est ignorée.

Sur .NET Framework, sTransparentNetworkIPResolution'il n'est pas spécifié dans l'chaîne de connexion, le pilote désactive automatiquement TNIR lorsque la source de données est un point de terminaison Azure SQL (.database.windows.net, .database.cloudapi.de, .database.chinacloudapi.cn.database.usgovcloudapi.net, ou .database.fabric.microsoft.com), lorsque la Authentication clé est définie sur n'importe quelle méthode Microsoft Entra ID (Active Directory Password, Active Directory IntegratedActive Directory Interactive, Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Managed Identity, , ou Active Directory DefaultActive Directory Workload IdentityActive Directory MSI) ou lorsque la ou AccessTokenCallback la AccessToken propriété est définie sur le SqlConnection. Pour ces conditions automatiques, une valeur explicite TransparentNetworkIPResolution contourne le comportement automatique : True active TNIR et False désactive TNIR de manière inconditionnelle. Pour rétablir le comportement automatique, supprimez le mot-clé de la chaîne de connexion.

Sur .NET (Core, .NET 5+), TransparentNetworkIPResolution n'est pas un mot clé de chaîne de connexion reconnu. La définition (avec n’importe quelle valeur) lève ArgumentException lorsque le pilote analyse la chaîne de connexion.

Sur .NET Framework, la valeur de cette clé doit être true, false, yesou no.

Une valeur de yes est traitée de la même façon qu’une valeur de true. Une valeur de no est traitée de la même façon qu’une valeur de false.