Uri Classe
TOC
Réduire la table des matières
Développer la table des matières
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Uri, classe

 

Fournit une représentation objet d'un URI (Uniform Resource Identifier) et un accès simplifié aux parties de l'identificateur.

Espace de noms:   System
Assembly:  System (dans System.dll)


[SerializableAttribute]
[TypeConverterAttribute(typeof(UriTypeConverter))]
public class Uri : ISerializable

NomDescription
System_CAPS_protmethodUri(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe Uri à partir des instances spécifiées des classes SerializationInfo et StreamingContext.

System_CAPS_pubmethodUri(String)

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié.

System_CAPS_pubmethodUri(String, Boolean)

Obsolète.Initialise une nouvelle instance de la classe Uri avec l'URI spécifié et contrôle explicite de l'échappement des caractères.

System_CAPS_pubmethodUri(String, UriKind)

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié. Ce constructeur vous permet de spécifier si la chaîne d'URI est un URI relatif, un URI absolu ou si elle est indéterminée.

System_CAPS_pubmethodUri(Uri, String)

Initialise une nouvelle instance de la classe Uri fondée sur l'URI de base et la chaîne URI relative spécifiés.

System_CAPS_pubmethodUri(Uri, String, Boolean)

Obsolète.Initialise une nouvelle instance de la classe Uri fondée sur les URI de base et relatifs spécifiés, avec contrôle explicite de l'échappement des caractères.

System_CAPS_pubmethodUri(Uri, Uri)

Initialise une nouvelle instance de la classe Uri en s'appuyant sur la combinaison d'une instance de Uri de base et d'une instance de Uri relative.

NomDescription
System_CAPS_pubpropertyAbsolutePath

Obtient le chemin d'accès absolu de l'URI.

System_CAPS_pubpropertyAbsoluteUri

Obtient l'URI absolu.

System_CAPS_pubpropertyAuthority

Obtient le nom de l'hôte DNS (Domain Name System) ou l'adresse IP et le numéro de port pour un serveur.

System_CAPS_pubpropertyDnsSafeHost

Obtient un nom d'hôte sans séquence d'échappement dont l'utilisation pour la résolution DNS est sécurisée.

System_CAPS_pubpropertyFragment

Obtient le fragment URI avec séquence d'échappement.

System_CAPS_pubpropertyHost

Obtient le composant hôte de cette instance.

System_CAPS_pubpropertyHostNameType

Obtient le type du nom d'hôte spécifié dans l'URI.

System_CAPS_pubpropertyIdnHost

Nom de domaine international conforme à la norme RFC 3490 de l'hôte, avec Punycode le cas échéant.

System_CAPS_pubpropertyIsAbsoluteUri

Obtient une valeur indiquant si l'instance Uri est absolue.

System_CAPS_pubpropertyIsDefaultPort

Obtient une valeur indiquant si la valeur du port de l'URI est la valeur par défaut pour ce schéma.

System_CAPS_pubpropertyIsFile

Obtient une valeur indiquant si le Uri spécifié est un URI de fichier.

System_CAPS_pubpropertyIsLoopback

Obtient une valeur indiquant si le Uri spécifié référence l'hôte local.

System_CAPS_pubpropertyIsUnc

Obtient une valeur indiquant si le Uri spécifié est un chemin d'accès UNC (Universal Naming Convention).

System_CAPS_pubpropertyLocalPath

Obtient une représentation du système d'exploitation local d'un nom de fichier.

System_CAPS_pubpropertyOriginalString

Obtient la chaîne d'URI d'origine passée au constructeur Uri.

System_CAPS_pubpropertyPathAndQuery

Obtient les propriétés AbsolutePath et Query séparées par un point d'interrogation (?).

System_CAPS_pubpropertyPort

Obtient le numéro de port de l'URI spécifié.

System_CAPS_pubpropertyQuery

Obtient les informations de requête incluses dans l'URI spécifié.

System_CAPS_pubpropertyScheme

Obtient le nom de schéma de cet URI.

System_CAPS_pubpropertySegments

Obtient un tableau contenant des segments de chemin d'accès qui composent l'URI spécifié.

System_CAPS_pubpropertyUserEscaped

Indique que la chaîne de l'URI a été placée intégralement dans une séquence d'échappement avant la création de l'instance de Uri.

System_CAPS_pubpropertyUserInfo

Obtient le nom d'utilisateur, le mot de passe et d'autres informations spécifiques à l'utilisateur associés à l'URI spécifié.

NomDescription
System_CAPS_protmethodCanonicalize()

Obsolète. Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Convertit l'URI stocké en interne au format réglementaire.

System_CAPS_pubmethodSystem_CAPS_staticCheckHostName(String)

Détermine si le nom d'hôte spécifié est un nom DNS valide.

System_CAPS_pubmethodSystem_CAPS_staticCheckSchemeName(String)

Détermine si le nom de schéma spécifié est valide.

System_CAPS_protmethodCheckSecurity()

Obsolète. Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. L'appel à cette méthode n'a aucun effet.

System_CAPS_pubmethodSystem_CAPS_staticCompare(Uri, Uri, UriComponents, UriFormat, StringComparison)

Compare les parties spécifiées de deux URI à l'aide des règles de comparaison spécifiées.

System_CAPS_pubmethodEquals(Object)

Compare si deux instances Uri sont égales.(Remplace Object.Equals(Object).)

System_CAPS_protmethodEscape()

Obsolète. Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Convertit tous les caractères non sécurisés ou réservés dans le composant de chemin d'accès en leurs présentations en caractères hexadécimaux.

System_CAPS_pubmethodSystem_CAPS_staticEscapeDataString(String)

Convertit une chaîne en sa représentation avec séquence d'échappement.

System_CAPS_protmethodSystem_CAPS_staticEscapeString(String)

Obsolète.Convertit une chaîne en sa représentation avec séquence d'échappement.

System_CAPS_pubmethodSystem_CAPS_staticEscapeUriString(String)

Convertit une chaîne URI en sa représentation sans séquence d'échappement.

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticFromHex(Char)

Obtient la valeur décimale d'un chiffre hexadécimal.

System_CAPS_pubmethodGetComponents(UriComponents, UriFormat)

Obtient les composants spécifiés de l'instance actuelle à l'aide de la séquence d'échappement spécifiée pour les caractères spéciaux.

System_CAPS_pubmethodGetHashCode()

Obtient le code de hachage pour l'URI.(Remplace Object.GetHashCode().)

System_CAPS_pubmethodGetLeftPart(UriPartial)

Obtient la partie spécifiée d'une instance Uri.

System_CAPS_protmethodGetObjectData(SerializationInfo, StreamingContext)

Retourne les données nécessaires à la sérialisation de l'instance actuelle.

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticHexEscape(Char)

Convertit un caractère spécifié en son équivalent hexadécimal.

System_CAPS_pubmethodSystem_CAPS_staticHexUnescape(String, Int32)

Convertit une représentation hexadécimale spécifiée d'un caractère en ce caractère.

System_CAPS_protmethodIsBadFileSystemCharacter(Char)

Obsolète. Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient une valeur indiquant si un caractère n'est pas valide dans un nom de système de fichiers.

System_CAPS_pubmethodIsBaseOf(Uri)

Détermine si l'instance de Uri actuelle est une base de l'instance de Uri spécifiée.

System_CAPS_protmethodSystem_CAPS_staticIsExcludedCharacter(Char)

Obsolète. Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient une valeur indiquant si le caractère spécifié doit être placé dans une séquence d'échappement.

System_CAPS_pubmethodSystem_CAPS_staticIsHexDigit(Char)

Détermine si un caractère spécifié est un chiffre hexadécimal valide.

System_CAPS_pubmethodSystem_CAPS_staticIsHexEncoding(String, Int32)

Détermine si un caractère d'une chaîne est encodé en hexadécimal.

System_CAPS_protmethodIsReservedCharacter(Char)

Obsolète. Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient une valeur indiquant si le caractère spécifié est réservé.

System_CAPS_pubmethodIsWellFormedOriginalString()

Indique si la chaîne utilisée pour construire ce Uri était bien formée et qu'elle ne doit pas également faire l'objet d'une séquence d'échappement.

System_CAPS_pubmethodSystem_CAPS_staticIsWellFormedUriString(String, UriKind)

Indique si la chaîne est bien formée en essayant de construire un URI avec la chaîne et garantit que la chaîne ne doit pas également faire l'objet d'une séquence d'échappement.

System_CAPS_pubmethodMakeRelative(Uri)

Obsolète.Détermine la différence entre deux instances de Uri.

System_CAPS_pubmethodMakeRelativeUri(Uri)

Détermine la différence entre deux instances de Uri.

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodParse()

Obsolète. Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Analyse l'URI de l'instance actuelle pour s'assurer qu'il contient toutes les parties requises pour un URI valide.

System_CAPS_pubmethodToString()

Obtient une représentation canonique sous forme de chaîne de l'instance de Uri.(Remplace Object.ToString().)

System_CAPS_pubmethodSystem_CAPS_staticTryCreate(String, UriKind, Uri)

Crée Uri à l'aide de l'instance de String spécifiée et de UriKind.

System_CAPS_pubmethodSystem_CAPS_staticTryCreate(Uri, String, Uri)

Crée un Uri à l'aide des instances de String de base et relatives.

System_CAPS_pubmethodSystem_CAPS_staticTryCreate(Uri, Uri, Uri)

Crée un Uri à l'aide des instances de Uri de base et relatives.

System_CAPS_protmethodUnescape(String)

Obsolète. Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Convertit la chaîne spécifiée en remplaçant toutes les séquences d'échappement par leur représentation sans séquence d'échappement.

System_CAPS_pubmethodSystem_CAPS_staticUnescapeDataString(String)

Convertit une chaîne en sa représentation sans séquence d'échappement.

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticSchemeDelimiter

Spécifie les caractères qui séparent le schéma du protocole de communication de la partie adresse de l'URI. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUriSchemeFile

Spécifie que l'URI est un pointeur vers un fichier. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUriSchemeFtp

Spécifie que l'URI est accessible par l'intermédiaire du protocole FTP (File Transfer Protocol). Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUriSchemeGopher

Spécifie que l'URI est accessible par l'intermédiaire du protocole Gopher. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUriSchemeHttp

Spécifie que l'URI est accessible par l'intermédiaire du protocole HTTP (Hypertext Transfer Protocol). Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUriSchemeHttps

Spécifie que l'URI est accessible par l'intermédiaire du protocole HTTPS (Secure Hypertext Transfer Protocol). Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUriSchemeMailto

Spécifie que l'URI est une adresse de messagerie accessible par l'intermédiaire du protocole SMTP (Simple Mail Transport Protocol). Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUriSchemeNetPipe

Spécifie que l'URI est accessible via le modèle NetPipe utilisé par Windows Communication Foundation (WCF). Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUriSchemeNetTcp

Spécifie que l'URI est accessible via le modèle NetTcp utilisé par Windows Communication Foundation (WCF). Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUriSchemeNews

Spécifie que l'URI est un groupe de discussion Internet accessible par le protocole NNTP (Network News Transport Protocol). Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUriSchemeNntp

Spécifie que l'URI est un groupe de discussion Internet accessible par le protocole NNTP (Network News Transport Protocol). Ce champ est en lecture seule.

NomDescription
System_CAPS_puboperatorSystem_CAPS_staticEquality(Uri, Uri)

Détermine si deux instances Uri ont la même valeur.

System_CAPS_puboperatorSystem_CAPS_staticInequality(Uri, Uri)

Détermine si deux instances de Uri n'ont pas la même valeur.

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

Retourne les données nécessaires à la sérialisation de l'instance actuelle.

Un URI est une représentation compacte d'une ressource disponible pour votre application sur l'intranet ou Internet. La Uri classe définit les propriétés et méthodes pour la gestion des URI, y compris l'analyse, la comparaison et la combinaison. Le Uri Propriétés de la classe sont en lecture seule ; pour créer un objet modifiable, utilisez la UriBuilder classe.

URI relatifs (par exemple, « / /New/index.htm ") doivent être développés par rapport à un URI de base pour qu'ils soient absolus. Le MakeRelative méthode est fournie pour convertir les URI absolus en identificateurs relatifs, lorsque cela est nécessaire.

Le Uri constructeurs ne puissent soustraire chaînes URI si la chaîne est un URI de forme correcte comprenant un identificateur de schéma.

Le Uri propriétés retournent une représentation de données canonique dans le codage avec séquence d'échappement, avec tous les caractères ayant des valeurs Unicode supérieures à 127 étant remplacés par leurs équivalents hexadécimaux. Pour mettre l'URI au format réglementaire, le Uri constructeur effectue les opérations suivantes :

  • Convertit le schéma URI en minuscules.

  • Convertit le nom d'hôte en minuscules.

  • Si le nom d'hôte est une adresse IPv6, l'adresse IPv6 réglementaire est utilisée. ScopeId et autres données IPv6 facultatives sont supprimées.

  • Supprime la valeur par défaut et les numéros de port vide.

  • Canonicalise tels que le chemin d'accès URI hiérarchiques en séquences /. /, /... / / /, y compris les représentations d'échappement. Notez que les représentations d'échappement pour certains schémas ne sont pas compactées.

  • URI hiérarchiques, si l'hôte n'est pas terminé par une barre oblique (/), une est ajoutée.

  • Par défaut, tous les caractères réservés dans l'URI d'échappement conformément à RFC 2396. Ce comportement change si les identificateurs de ressources International ou nom de domaine International l'analyse est activée dans les cas les caractères réservés dans l'URI d'échappement conformément à RFC 3986 et RFC 3987.

Dans le cadre de la canonisation dans le constructeur de certains schémas, les représentations d'échappement sont compactées. Les schémas pour lesquels l'URI condense des séquences d'échappement sont les suivants : fichier, http, https, net.pipe et net.tcp. Pour tous les autres schémas, les séquences d'échappement ne sont pas compactées. Par exemple : Si vous encodez en pourcentage les deux points «.. » comme « % 2E % 2E » puis le constructeur d'URI compacte cette séquence pour certains modèles. Par exemple, l'exemple de code suivant montre un constructeur d'URI pour le schéma http.


Uri uri = new Uri("http://myUrl/%2E%2E/%2E%2E");
Console.WriteLine(uri.AbsoluteUri);
Console.WriteLine(uri.PathAndQuery);

Lorsque ce code est exécuté, il retourne la sortie suivante avec la séquence d'échappement condensée.


http://myUrl/
/

L'exemple de code suivant montre un constructeur d'URI pour le schéma ftp :


Uri uri = new Uri("ftp://myUrl/%2E%2E/%2E%2E");
Console.WriteLine(uri.AbsoluteUri);
Console.WriteLine(uri.PathAndQuery);

Lorsque ce code est exécuté, il retourne la sortie suivante avec la séquence d'échappement pas compacté.


ftp://myUrl/%2E%2E/%2E%2E
/%2E%2E/%2E%2E

Vous pouvez transformer le contenu de la Uri classe à partir d'une référence d'URI d'échappement encodée en une référence URI lisible à l'aide de la ToString méthode. Notez que certains caractères réservés peuvent encore être ignorés dans la sortie de la ToString méthode. Il s'agit de prendre en charge la reconstitution non équivoque d'un URI à partir de la valeur retournée par ToString.

Certains URI comprennent un identificateur de fragment ou une requête ou les deux. Un identificateur de fragment est n'importe quel texte qui suit le signe dièse (#), non compris le signe dièse ; le fragment de texte est stocké dans le Fragment propriété. Informations de requête sont n'importe quel texte qui suit un point d'interrogation (?) dans l'URI ; le texte de requête est stocké dans le Query propriété.

Dans le .NET Framework version 1.1, si la chaîne spécifiée à un constructeur contient un schéma inconnu et « c:\ », la classe Uri insère "/ /" après les deux-points. Par exemple, l'URI xyz:c:\abc est convertie en xyz://c:/abc. Dans le .NET Framework version 2.0, ce comportement a été supprimé et la chaîne d'exemple est convertie en xyz:c:/abc.

System_CAPS_noteRemarque

La classe URI prend en charge l'utilisation d'adresses IP dans les deux quad-notation du protocole IPv4 et hexadécimale à deux-points du protocole IPv6. N'oubliez pas d'inclure l'adresse IPv6 entre crochets, comme dans http://[::1].

Les adresses Web sont généralement exprimées à l'aide d'identificateurs de ressource uniforme qui se composent d'un ensemble très limité de caractères :

  • Majuscules et ASCII minuscules de l'alphabet anglais.

  • Chiffres de 0 à 9.

  • Un petit nombre d'autres symboles ASCII.

Les spécifications applicables aux URI sont documentées dans la norme RFC 2396, RFC 2732, RFC 3986 et RFC 3987 publiées par l'IETF Internet Engineering Task Force ().

Avec la croissance de l'Internet, il est un besoin croissant pour identifier les ressources à l'aide de langues autres que l'anglais. Identificateurs de faciliter ce besoin et autoriser des caractères non-ASCII (caractères dans le jeu de caractères Unicode/ISO 10646) sont des identificateurs de ressources International (IRIs). Les spécifications concernant les IRI sont documentées dans RFC 3987 publiées par l'IETF. À l'aide d'IRIs permet à une URL de contenir des caractères Unicode.

Existant Uri classe a été étendue dans .NET Framework v3.5, 3.0 SP1 et 2.0 SP1 pour fournir la prise en charge IRI basée sur RFC 3987. Les utilisateurs de versions du .NET Framework avant la version 4.5 ne verront pas de toute modification du comportement de .NET Framework 2.0 à moins qu'ils activent spécifiquement des IRI. Cela garantit la compatibilité des applications avec les versions antérieures du .NET Framework.

Pour activer la prise en charge des IRI, la modification suivante est requise :

  • Spécifiez si vous souhaitez l'analyse des IDN (Internationalized Domain nom) appliquée au nom de domaine et si les règles d'analyse ini doit être appliquée. Cela est possible dans le fichier machine.config ou dans le fichier app.config. Par exemple, ajoutez les éléments suivants :

    <configuration>
      <uri>
      <idn enabled="All" />
      <iriParsing enabled="true" />
      </uri>
    </configuration>
    

Les utilisateurs de .NET Framework 4.5 et versions ultérieures ont toujours IRI activé. L'analyse IRI ne peut pas être modifié à l'aide d'un fichier .config.

L'activation des IDN convertira toutes les étiquettes Unicode d'un nom de domaine en leurs équivalents Punycode. Les noms Punycode contiennent uniquement des caractères ASCII et commencent toujours par le préfixe xn--. La raison à cela consiste à prendre en charge des serveurs DNS existants sur Internet, étant donné que la plupart des serveurs DNS prennent uniquement en charge les caractères ASCII (consultez RFC 3940).

L'activation des IRI et IDN affecte la valeur de la Uri.DnsSafeHost propriété. L'activation des IRI et IDN permettre également modifier le comportement de la Equals, OriginalString, GetComponents, et IsWellFormedOriginalString méthodes.

Il existe trois valeurs possibles pour l'IDN selon les serveurs DNS utilisés :

  • IDN activé = All

    Cette valeur convertit tous les noms de domaine Unicode en leurs équivalents Punycode (noms IDN).

  • IDN activé = AllExceptIntranet

    Cette valeur convertit tous les noms de domaine Unicode pas sur l'Intranet local pour utiliser les équivalents Punycode (noms IDN). Dans ce cas pour gérer des noms internationaux sur l'Intranet local, les serveurs DNS qui sont utilisés pour l'Intranet doivent prendre en charge les noms Unicode.

  • IDN activé = aucune

    Cette valeur ne convertit tous les noms de domaine Unicode pour utiliser Punycode. Il s'agit de la valeur par défaut qui est cohérente avec le comportement de .NET Framework 2.0.

Lorsque l'analyse IRI est activée (iriParsing activé = true) la normalisation et la vérification des caractères sont effectuées selon les dernières règles IRI de RFC 3986 et RFC 3987. Lors de l'analyse IRI est désactivé, la normalisation et la vérification des caractères sont effectuées selon la norme RFC 2396 et RFC 2732 (pour les littéraux IPv6). Dans les versions du .NET Framework antérieures à la version 4.5, la valeur par défaut est false. Dans .NET Framework version 4.5 et ultérieure, la valeur par défaut est true, et l'état activé de l'analyse IRI ne peut pas être modifié par les paramètres dans un fichier .config.

IRI et traitement des IDN dans la Uri classe peut également être contrôlée à l'aide de la System.Configuration.IriParsingElement, System.Configuration.IdnElement, et System.Configuration.UriSection classes de paramètre de configuration. Le System.Configuration.IriParsingElement paramètre Active ou désactive le traitement des IRI dans la Uri classe. Le System.Configuration.IdnElement paramètre Active ou désactive le traitement des IDN dans la Uri classe. Le System.Configuration.IriParsingElement paramètre contrôle également indirectement IDN. Le traitement des IRI doit être activé pour l'IDN possible du traitement. Si le traitement des IRI est désactivé, traitement des IDN être définit le paramètre par défaut où le comportement de .NET Framework 2.0 est utilisé pour la compatibilité et les noms IDN ne sont pas utilisés.

Le paramètre de configuration pour la System.Configuration.IriParsingElement et System.Configuration.IdnElement sera lue une fois lorsque la première System.Uri classe est créée. Modifications apportées aux paramètres de configuration après cette heure sont ignorées.

La System.GenericUriParser classe a également été étendue pour permettre la création d'un analyseur personnalisable qui prend en charge IRI et IDN. Le comportement d'un System.GenericUriParser objet est spécifié en passant une combinaison d'opérations de bits des valeurs disponibles dans le System.GenericUriParserOptions énumération à la System.GenericUriParser constructeur. Le GenericUriParserOptions.IriParsing type indique l'analyseur prend en charge les règles d'analyse spécifiées dans RFC 3987 pour les identificateurs IRI (International Resource). IRI est dictée par les valeurs de configuration évoquées précédemment.

Le GenericUriParserOptions.Idn type indique l'analyseur prend en charge le nom de domaine internationalisé (IDN) l'analyse (IDN Internationalized) des noms d'hôte. IDN est dictée par les valeurs de configuration évoquées précédemment.

Si vous utilisez un fichier Web.config qui contient des URI pour initialiser votre application, le temps supplémentaire est requis pour traiter les URI si leurs identificateurs de schéma ne sont pas standard. Dans ce cas, initialisez les parties affectées de votre application lorsque les URI sont requis, pas au démarrage.

Remarques à l'attention des appelants :

Pour des raisons de sécurité, votre application doit utiliser attention lors de l'acceptation Uri instances à partir de sources non fiables et avec dontEscape défini sur true. Vous pouvez vérifier la validité une chaîne URI en appelant le IsWellFormedOriginalString (méthode).

L'exemple suivant crée une instance de la Uri classe et l'utilise pour créer un WebRequest instance.

Uri siteUri = new Uri("http://www.contoso.com/");

WebRequest wr = WebRequest.Create(siteUri);

Universal Windows Platform
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher:
© 2016 Microsoft