Uri.IdnHost Vlastnost

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

Uri.cs

Získá RFC 3490 kompatibilní mezinárodní název domény hostitele pomocí punycode podle potřeby. Tento řetězec po zrušení v případě potřeby je bezpečný pro překlad DNS.

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

public string IdnHost { get; }

member this.IdnHost : string

Public ReadOnly Property IdnHost As String

Hodnota vlastnosti

String

Název hostitele formátovaný punycode podle standardu IDN.

Výjimky

InvalidOperationException

Tato instance představuje relativní identifikátor URI a tato vlastnost je platná pouze pro absolutní identifikátory URI.

Poznámky

Tato vlastnost je poskytována pro použití síťových protokolů nižší úrovně, které vyžadují název domény ve formuláři Punycode. Pokud váš kód tento konkrétní formát nevyžaduje, použijte Host ho pro název hostitele.

Zastaralá DnsSafeHost vlastnost závisí na nastaveníapp.config , která nelze změnit aplikacemi pro Windows Store. IdnHost je poskytován jako upřednostňovaná alternativa k použití DnsSafeHost, protože IdnHost je zaručeno, že vždy být bezpečný DNS, bez ohledu na to, co může být aktuální nastaveníapp.config .

Pokud jste k vytvoření této instance použili řídicí řetězec (například "http://[fe80::200:39ff:fe36:1a2d%254]/temp/example.htm"), vrátí IdnHost řídicí řetězec. Před použitím daného řetězce pro překlad DNS byste měli zrušit všechny řídicí řetězce vrácené z IdnHost. Mějte na paměti, že pokud jste použili neplatný unescaped řetězec k vytvoření této instance (například "http://[fe80::200:39ff:fe36:1a2d%4]/temp/example.htm"), pak IdnHost vrátí unescaped řetězec.