SqlConnectionStringBuilder.TransparentNetworkIPResolution Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v7.1.0

Perhatian

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

Pada .NET Framework, ketika nilai kunci ini diatur ke true, driver menjalankan beberapa putaran koneksi di seluruh alamat IP yang diselesaikan DNS, dengan batas waktu per upaya yang semakin besar dan minimum 500 md pada upaya mode berurutan, sampai koneksi berhasil atau keseluruhan Connect Timeout tercapai.

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

Nilai Properti

Boolean

Nilai boolean.

Atribut

ObsoleteAttribute

Keterangan

Properti ini sudah usang. Gunakan MultiSubnetFailover sebagai gantinya.

Jika kunci Multi Subnet Failover diatur ke true, Transparent Network IP Resolution diabaikan.

Jika kunci Failover Partner diatur, Transparent Network IP Resolution diabaikan.

Pada .NET Framework, jika TransparentNetworkIPResolution tidak ditentukan dalam string koneksi, driver secara otomatis menonaktifkan TNIR ketika sumber data adalah titik akhir Azure SQL (.database.windows.net, , .database.cloudapi.de, .database.usgovcloudapi.net.database.chinacloudapi.cn, atau .database.fabric.microsoft.com), ketika Authentication kunci diatur ke metode Microsoft Entra ID apa pun (Direktori Aktif Password, Direktori Aktif Service PrincipalDirektori Aktif InteractiveDirektori Aktif IntegratedDirektori Aktif Managed IdentityDirektori Aktif MSIDirektori Aktif Device Code Flow, Direktori Aktif Default, atau Direktori Aktif Workload Identity), atau ketika AccessToken properti atau AccessTokenCallback diatur pada SqlConnection. Untuk kondisi otomatis ini, nilai eksplisit TransparentNetworkIPResolution melewati perilaku otomatis: True mengaktifkan TNIR, dan False menonaktifkan TNIR tanpa syarat. Untuk mengembalikan perilaku otomatis, hapus kata kunci dari string koneksi.

Pada .NET (Core, .NET 5+), TransparentNetworkIPResolution bukan kata kunci string koneksi yang dikenali. Mengaturnya (dengan nilai apa pun) muncul ArgumentException saat driver mengurai string koneksi.

Pada .NET Framework, nilai kunci ini harus true, , falseyes, atau no.

Nilai yes diperlakukan sama dengan nilai true. Nilai no diperlakukan sama dengan nilai false.