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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Internet Engineering Task Force (IETF)

Partager via