Uri.IdnHost Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System
Zestaw:
System.Runtime.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
Uri.cs
Źródło:
Uri.cs
Źródło:
Uri.cs

Pobiera zgodną międzynarodową nazwę domeny hosta RFC 3490 przy użyciu narzędzia Punycode zgodnie z potrzebami. Ten ciąg, po usunięciu pejzażu w razie potrzeby, jest bezpieczny do użycia na potrzeby rozpoznawania nazw DNS.

public:
 property System::String ^ IdnHost { System::String ^ get(); };
public string IdnHost { get; }
member this.IdnHost : string
Public ReadOnly Property IdnHost As String

Wartość właściwości

String

Nazwa hosta, sformatowana za pomocą narzędzia Punycode zgodnie ze standardem IDN.

Wyjątki

InvalidOperationException

To wystąpienie reprezentuje względny identyfikator URI, a ta właściwość jest prawidłowa tylko dla bezwzględnych identyfikatorów URI.

Uwagi

Ta właściwość jest udostępniana do używania protokołów sieciowych niższego poziomu, które wymagają nazwy domeny w formularzu Punycode. Jeśli kod nie wymaga tego określonego formatu, użyj Host nazwy hosta.

Przestarzała DnsSafeHost właściwość jest zależna od ustawień app.config , których nie można zmienić przez aplikacje ze Sklepu Windows. IdnHost jest udostępniany jako preferowana alternatywa dla używania elementu DnsSafeHost, ponieważ IdnHost gwarantuje, że zawsze jest bezpieczny DNS, bez względu na to, jakie mogą być bieżące ustawienia app.config .

Jeśli użyto ciągu ucieczki do skonstruowania tego wystąpienia (na przykład "http://[fe80::200:39ff:fe36:1a2d%254]/temp/example.htm"), funkcja IdnHost zwraca ciąg ucieczki. Przed użyciem tego ciągu do rozpoznawania nazw DNS należy usunąć dowolny ciąg ucieczki zwrócony z hosta IdnHost. Należy pamiętać, że jeśli użyto nieprawidłowego ciągu unescaped do skonstruowania tego wystąpienia (na przykład "http://[fe80::200:39ff:fe36:1a2d%4]/temp/example.htm"), funkcja IdnHost zwraca niezauważony ciąg.

Dotyczy