Uri.IdnHost Eigenschaft

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Quelle:

Uri.cs

Ruft den mit RFC 3490 kompatiblen IDN (Internationaler Domänenname) des Hosts ab, wofür ggf. Punycode verwendet wird. Diese Zeichenfolge kann sicher für die DNS-Auflösung verwendet werden, da sie keine Escapezeichen enthält.

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, der mit Punycode gemäß dem IDN-Standard formatiert ist.

Ausnahmen

InvalidOperationException

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

Hinweise

Diese Eigenschaft wird für die Verwendung von Netzwerkprotokollen auf niedrigerer Ebene bereitgestellt, für die der Domänenname in Punycode-Form erforderlich ist. Wenn Ihr Code dieses spezifische Format nicht erfordert, verwenden Sie Host für den Hostnamen.

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

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