Uri.IdnHost Eigenschaft

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

Uri.cs

Ruft den RFC 3490-kompatiblen internationalen Domänennamen des Hosts ab, wobei Punycode entsprechend verwendet wird. Diese Zeichenfolge, nachdem sie bei Bedarf nicht gescapet wurde, ist sicher für die DNS-Auflösung zu verwenden.

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

public string IdnHost { get; }

member this.IdnHost : string

Public ReadOnly Property IdnHost As String

Eigenschaftswert

String

Der Hostname, formatiert mit Punycode gemäß dem IDN-Standard.

Ausnahmen

InvalidOperationException

Diese Instanz stellt einen relativen URI dar, und diese Eigenschaft ist nur für absolute URIs gültig.

Hinweise

Diese Eigenschaft wird für die Verwendung von Netzwerkprotokollen auf niedrigerer Ebene bereitgestellt, die den Domänennamen in Punycode-Form erfordern. Wenn ihr Code dieses spezifische Format nicht erfordert, verwenden Sie Host dies für den Hostnamen.

Die veraltete DnsSafeHost Eigenschaft hängt von app.config Einstellungen ab, die von Windows Store-Anwendungen nicht geändert werden können. IdnHost wird als bevorzugte Alternative zur Verwendung DnsSafeHostbereitgestellt, da IdnHost garantiert immer DNS-sicher ist, unabhängig davon, was die aktuellen app.config Einstellungen sein können.

Wenn Sie zum Erstellen dieser Instanz eine Escapezeichenfolge verwendet haben (z "http://[fe80::200:39ff:fe36:1a2d%254]/temp/example.htm". B. ), gibt IdnHost eine Escapezeichenfolge zurück. Sie sollten alle escaped-Zeichenfolgen, die von IdnHost zurückgegeben werden, aufheben, bevor Sie diese Zeichenfolge für die DNS-Auflösung verwenden. Beachten Sie, dass, wenn Sie zum Erstellen dieser Instanz eine ungültige unescaped-Zeichenfolge verwendet haben (z. B. "http://[fe80::200:39ff:fe36:1a2d%4]/temp/example.htm"), dann gibt IdnHost eine nicht dargestellte Zeichenfolge zurück.