SqlConnectionStringBuilder.TransparentNetworkIPResolution Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Uwaga
TransparentNetworkIPResolution has been deprecated and is only supported on .NET Framework. Use MultiSubnetFailover instead.
Na platformie .NET Framework, gdy wartość tego klucza jest ustawiona na true, sterownik uruchamia wiele rund połączenia między adresami IP rozpoznawanymi przez system DNS, z stopniowo większymi limitami czasu na próbę i minimum 500 ms próby sekwencyjnej, dopóki połączenie nie powiedzie się lub zostanie osiągnięte ogólneConnect Timeout.
public:
property bool TransparentNetworkIPResolution { bool get(); void set(bool value); };public bool TransparentNetworkIPResolution { get; set; }[System.Obsolete("TransparentNetworkIPResolution has been deprecated and is only supported on .NET Framework. Use MultiSubnetFailover instead.")]
public bool TransparentNetworkIPResolution { get; set; }member this.TransparentNetworkIPResolution : bool with get, set[<System.Obsolete("TransparentNetworkIPResolution has been deprecated and is only supported on .NET Framework. Use MultiSubnetFailover instead.")>]
member this.TransparentNetworkIPResolution : bool with get, setPublic Property TransparentNetworkIPResolution As BooleanWartość właściwości
Wartość logiczna.
- Atrybuty
Uwagi
Ta właściwość jest przestarzała. Użyj MultiSubnetFailover zamiast tego.
Multi Subnet Failover Jeśli klucz jest ustawiony na truewartość , Transparent Network IP Resolution jest ignorowany.
Failover Partner Jeśli klucz jest ustawiony, Transparent Network IP Resolution jest ignorowany.
Jeśli nie określono .NET Framework TransparentNetworkIPResolution w parametry połączenia, sterownik automatycznie wyłącza funkcję TNIR, gdy źródło danych jest punktem końcowym Azure SQL (, .database.cloudapi.de, .database.chinacloudapi.cn.database.usgovcloudapi.net, lub .database.fabric.microsoft.com), gdy Authentication klucz jest ustawiony na dowolną metodę Microsoft Entra ID (Active Directory Password.database.windows.net, Active Directory Integrated, Active Directory Service PrincipalActive Directory InteractiveActive Directory Managed IdentityActive Directory MSIActive Directory Device Code FlowActive Directory Defaultlub )Active Directory Workload Identity), lub gdy AccessToken właściwość or AccessTokenCallback jest ustawiona SqlConnectionna . W przypadku tych warunków automatycznych jawna TransparentNetworkIPResolution wartość pomija zachowanie automatyczne: True włącza funkcję TNIR i False wyłącza funkcję TNIR bezwarunkowo. Aby przywrócić automatyczne zachowanie, usuń słowo kluczowe z parametry połączenia.
W .NET (Core, .NET 5+) TransparentNetworkIPResolution nie jest rozpoznanym słowem kluczowym parametrów połączenia. Ustawienie go (z dowolną wartością) jest zgłaszaneArgumentException, gdy sterownik analizuje parametry połączenia.
W .NET Framework wartość tego klucza musi mieć truewartość , false, yeslub no.
Wartość elementu jest traktowana yes tak samo jak wartość true. Wartość elementu jest traktowana no tak samo jak wartość false.