Uri.IdnHost 屬性

定義

命名空間:

System

組件:

System.Runtime.dll

組件:

System.dll

組件:

netstandard.dll

取得主機符合 RFC 3490 標準的國際網域名稱，並適當地使用 Punycode。 這個字串在視需要取消逸出後，可放心用於 DNS 解析。

public:
 property System::String ^ IdnHost { System::String ^ get(); };

public string IdnHost { get; }

member this.IdnHost : string

Public ReadOnly Property IdnHost As String

屬性值

String

主機名稱，根據 IDN 標準以 Punycode 格式化。

例外狀況

InvalidOperationException

這個執行個體代表相對的 URI，而這個屬性只適用於絕對 URI。

備註

這個屬性是針對使用需要 Punycode 格式之功能變數名稱的較低層級網路通訊協定所提供。 如果您的程式碼不需要該特定格式，請使用 Host 做為主機名稱。

已被取代 DnsSafeHost 的屬性相依于 app.config 設定，Windows Microsoft Store應用程式無法變更這些設定。 IdnHost 是以慣用的 DnsSafeHost 替代方式提供，因為 IdnHost 無論目前的 app.config 設定為何，保證一律為 DNS 安全。

例如，如果您使用逸出字串來建構此實例 (， "http://[fe80::200:39ff:fe36:1a2d%254]/temp/example.htm") ，則 IdnHost 會傳回逸出字串。 您應該先取消逸出從 IdnHost 傳回的任何逸出字串，再使用該字串進行 DNS 解析。 請注意，如果您使用不正確未逸出字串來建構此實例 (，例如「HTTP://[fe80：：200：39ff：fe36：1a2d%4]/temp/example.htm」) ，IdnHost 會傳回未逸出的字串。