Uri.IdnHost Propriété

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

Uri.cs

Obtient le nom de domaine international conforme RFC 3490 de l’hôte, en utilisant Punycode comme il convient. Cette chaîne, après avoir été déchaînée si nécessaire, est sûre à utiliser pour la résolution DNS.

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

public string IdnHost { get; }

member this.IdnHost : string

Public ReadOnly Property IdnHost As String

Valeur de propriété

String

Nom d’hôte, mis en forme avec Punycode en fonction de la norme IDN.

Exceptions

InvalidOperationException

Cette instance représente un URI relatif et cette propriété est valide uniquement pour les URI absolus.

Remarques

Cette propriété est fournie pour l’utilisation de protocoles de mise en réseau de niveau inférieur qui nécessitent le nom de domaine sous forme Punycode. Si votre code ne nécessite pas ce format spécifique, utilisez Host le nom d’hôte.

La propriété déconseillée DnsSafeHost dépend des paramètres app.config , qui ne peuvent pas être modifiés par les applications du Windows Store. IdnHost est fourni comme alternative préférée à l’utilisation DnsSafeHost, car IdnHost il est garanti qu’il soit toujours sécurisé DNS, quel que soit leapp.configactuel des paramètres.

Si vous avez utilisé une chaîne d’échappement pour construire cette instance (par exemple, "http://[fe80::200:39ff:fe36:1a2d%254]/temp/example.htm"), IdnHost retourne une chaîne d’échappement. Vous devez annuler l’échappement d’une chaîne retournée par IdnHost avant d’utiliser cette chaîne pour la résolution DNS. N’oubliez pas que si vous avez utilisé une chaîne non exécutée non valide pour construire cette instance (par exemple, « http://[fe80 ::200:39ff :fe36:1a2d%4]/temp/example.htm»), idnHost retourne une chaîne non échauffée.