SqlConnectionStringBuilder.TransparentNetworkIPResolution Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v7.1.0

Cuidado

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

No .NET Framework, quando o valor dessa chave é definido como true, o driver executa várias rodadas de conexão entre os endereços IP resolvidos por DNS, com tempos limite por tentativa progressivamente maiores e um mínimo de 500 ms na tentativa de modo sequencial, até que uma conexão seja bem-sucedida ou o geral Connect Timeout seja atingido.

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

Valor da propriedade

Boolean

Um valor booliano.

Atributos

ObsoleteAttribute

Comentários

Esta propriedade é obsoleta. Use MultiSubnetFailover em seu lugar.

Se a Multi Subnet Failover chave estiver definida como true, Transparent Network IP Resolution será ignorada.

Se a Failover Partner chave estiver definida, Transparent Network IP Resolution será ignorada.

No .NET Framework, se TransparentNetworkIPResolution não for especificado no cadeia de conexão, o driver desabilita automaticamente o TNIR quando a fonte de dados é um ponto de extremidade SQL do Azure (.database.windows.net, , .database.cloudapi.de, .database.usgovcloudapi.net.database.chinacloudapi.cnou .database.fabric.microsoft.com), quando a Authentication chave é definida como qualquer método Microsoft Entra ID (Active Directory Password, , Active Directory Integrated, Active Directory InteractiveActive Directory Service Principal, Active Directory Device Code Flow, Active Directory Managed Identity, Active Directory MSI, Active Directory Default, ou Active Directory Workload Identity), ou quando a propriedade ou AccessTokenCallback é AccessToken definida no SqlConnection. Para essas condições automáticas, um valor explícito TransparentNetworkIPResolution ignora o comportamento automático: True habilita o TNIR e False desabilita o TNIR incondicionalmente. Para restaurar o comportamento automático, remova a palavra-chave da cadeia de conexão.

Em .NET (Core, .NET 5+), TransparentNetworkIPResolution não é uma palavra-chave de cadeia de conexão reconhecida. Defini-lo (com qualquer valor) é gerado ArgumentException quando o driver analisa o cadeia de conexão.

No .NET Framework, o valor dessa chave deve ser true, , falseou yesno.

Um valor de yes é tratado da mesma forma que um valor de true. Um valor de no é tratado da mesma forma que um valor de false.