Uri.IdnHost Propriété

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Obtient le nom de domaine international conforme RFC 3490 de l’hôte, à l’aide de Punycode comme approprié. Cette chaîne, une fois sans séquence d’échappement si nécessaire, peut être utilisée en toute sécurité 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 uniquement valide 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 dans le formulaire 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ètresapp.config, qui ne peuvent pas être modifiés par Windows applications du Windows Store. IdnHost est fourni comme alternative préférée à l’utilisation DnsSafeHost, car IdnHost il est garanti d’être toujours sécurisé DNS, quel que soit le app.config actuel 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 valide pour construire cette instance (par exemple, « http://[fe80::200:39ff:fe36:1a2d%4]/temp/example.htm »), IdnHost retourne une chaîne non bouclée.