Uri.IsWellFormedUriString(String, UriKind) Méthode

  • Référence

Définition

Espace de noms:
System
Assembly:
System.Runtime.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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.

public:
 static bool IsWellFormedUriString(System::String ^ uriString, UriKind uriKind);
public static bool IsWellFormedUriString (string uriString, UriKind uriKind);
public static bool IsWellFormedUriString (string? uriString, UriKind uriKind);
static member IsWellFormedUriString : string * UriKind -> bool
Public Shared Function IsWellFormedUriString (uriString As String, uriKind As UriKind) As Boolean

Paramètres

uriString
String

Chaîne utilisée pour tenter de construire un Uri.

uriKind
UriKind

Type de Uri dans uriString.

Retours

Boolean

true si la chaîne était bien formée ; sinon, false.

Remarques

Dans les versions de .NET avant la version 4.5, par défaut, la chaîne est considérée comme bien formée conformément à RFC 2396 et RFC 2732. Si l’analyse IDN (International Resource Identifiers) ou INTERNATIONALized Domain Name (IDN) est activée, la chaîne est considérée comme bien formée conformément à RFC 3986 et RFC 3987.

À compter de .NET 4.5, les chaînes sont toujours considérées comme bien formées conformément à RFC 3986 et RFC 3987, que l’IRI ou l’IDN soient activés. Notez toutefois que cela est vrai uniquement pour les applications qui ciblent .NET 4.5 ou version ultérieure. Les applications qui ciblent .NET 4.0 appellent le code de compatibilité et rencontrent l’ancien comportement (pré-4.5).

La chaîne est considérée comme mal formée, ce qui entraîne le retour de la méthode false, si l’une des conditions suivantes se produit

Erreur Exemple
La chaîne n’est pas correctement échappée. http://www.contoso.com/path???/file name
La chaîne est un absolu Uri qui représente un fichier Uriimplicite . c:\\directory\filename
La chaîne est un URI absolu qui manque une barre oblique avant le chemin d’accès. file://c:/directory/filename
La chaîne contient des barres obliques inverses non échapées, même si elles seront traitées comme des barres obliques http:\\\host/path/file
La chaîne représente un absolu Uri hiérarchique et ne contient pas « :// » www.contoso.com/path/file
L’analyseur pour les Scheme indique que la chaîne d’origine n’a pas été bien formée. L’exemple dépend du schéma de l’URI.
À compter de .NET 4.5, les URI relatifs avec un signe deux-points (':') dans leur premier segment ne sont pas considérés comme bien formés. 2013.05.29_14:33:41

Pour plus d’informations sur la prise en charge de l’IRI, consultez la section Notes de la Uri classe.

S’applique à

Voir aussi