Uri.IdnHost 属性

定义

命名空间:

System

程序集:

System.Runtime.dll

程序集:

System.dll

程序集:

netstandard.dll

根据需要使用 Punycode，获取主机的符合 RFC 3490 标准的国际域名。 该字符串在不进行转义的情况下（如必要）可安全用于 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 返回转义字符串。 在使用该字符串进行 DNS 解析之前，应取消从 IdnHost 返回的任何转义字符串。 请注意，如果使用无效的未转义字符串构造此实例， (例如“http://[fe80：：200：39ff：fe36：1a2d%4]/temp/example.htm”) ，则 IdnHost 返回未转义字符串。