Uri Class

Analyse des identificateurs URI (Uniform Resource Identifiers).

.NET:  Ce type apparaît sous forme de System.Uri.

Syntaxe


var uri = new Windows.Foundation.Uri(string);
var uri = new Windows.Foundation.Uri(string, string);

Attributs

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Membres

UriClasse possède ces types de membres :

Constructeurs

UriClasse possède ces constructeurs.

ConstructeurDescription
Uri(String) Creates a Uniform Resource Identifier (URI) from the specified string.
Uri(String, String) Creates a Uniform Resource Identifier (URI) by combining a base Uniform Resource Identifier (URI) and a relative Uniform Resource Identifier (URI).

 

Méthodes

The Uri Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
CombineUri Adds the specified Uniform Resource Identifier (URI) to the current Uniform Resource Identifier (URI).
Equals(Uri) Determines whether the specified Uniform Resource Identifier (URI) is equal to the current Uniform Resource Identifier (URI).
EscapeComponent Converts a URI string to its escaped representation.
ToString Gets a canonical string representation for the current Uri.
UnescapeComponent Converts the specified string by replacing any escape sequences with their unescaped representation.

 

Propriétés

Le UriClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

AbsoluteCanonicalUri

En lecture seuleGets a fully canonicalized RFC-complaint representation of the current URI.

AbsoluteUri

En lecture seuleGets the entire, non-canonical IRI.

DisplayIri

En lecture seuleGets the decoded unicode characters that make up the current URI.

DisplayUri

En lecture seuleGets a representation of the IRI that can be used for display purposes.

Domain

En lecture seuleGets the domain name, including top-level domain, from a Uniform Resource Identifier (URI).

Extension

En lecture seuleGets the file name extension of the resource that is referenced in the Uniform Resource Identifier (URI).

Fragment

En lecture seuleGets the text following a fragment marker (#), including the fragment marker itself.

Host

En lecture seuleGets the fully qualified domain name.

Password

En lecture seuleGets the password, as parsed from a Uniform Resource Identifier (URI).

Path

En lecture seuleGets the path and resource name.

Port

En lecture seuleGets the port number.

Query

En lecture seuleGets the query string.

QueryParsed

En lecture seuleGets a parsed URL query string.

RawUri

En lecture seuleGets the entire original Uniform Resource Identifier (URI) string.

SchemeName

En lecture seuleGets the protocol scheme name.

Suspicious

En lecture seuleGets a value that indicates whether the Uniform Resource Identifier (URI) is not well-formed.

UserName

En lecture seuleGets the user name as parsed from a Uniform Resource Identifier (URI).

 

Remarques

Lors de la génération des applications Windows Store avec Microsoft .NET Framework, cette classe est masquée et les développeurs doivent utiliser la classe System.Uri qui utilise la norme RFC 3987 pour encoder et décoder les URI. La classe Uri n'encode pas en pourcentage les caractères non ASCII dans file:// URI et interprète l'encodage en pourcentage à l'aide de la page de codes actuelle de l'utilisateur.

Voici une répartition des parties d'un exemple d'URI :

scheme://username:password@host:port/path.extension?query#fragment

Par exemple :

ftp://user:password@ftp.microsoft.com:8080/path/bin/file.asp?q=query#fragment

Dans cet exemple :

  • scheme est ftp
  • host est ftp.microsoft.com
  • domain a la valeur microsoft.com (un sous-ensemble de host)
  • port est 8080
  • extension est asp

Exemples

Cet exemple crée un URI qui utilise le protocole HTTP pour accéder à un site Web.


// The URI string
var uriToLaunch = "http://www.bing.com";

// Create a Uri object from the URI string 
var uri = new Windows.Foundation.Uri(uriToLaunch);

Cet exemple crée un URI qui utilise le protocole ms-appx pour accéder à un fichier image dans le package d'application.


// The URI string
var uriImage = "ms-appx:///images/SecondaryTileDefault-sdk.png";

// Create a Uri object from the URI string
var uri = new Windows.Foundation.Uri(uriImage);

Cet exemple crée un URI qui utilise le protocole ms-appdata pour accéder à un fichier dans le magasin de données local de votre application.


// The URI string
var uriFile = "ms-appdata:///local/file.ext";

// Create a Uri object from the URI string
var uri = new Windows.Foundation.Uri(uriFile);

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store, applications de bureau]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store, applications de bureau]

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

Windows.Foundation
Windows::Foundation [C++]

Métadonnées

Windows.winmd

Voir aussi

Comment référencer le contenu

 

 

Afficher:
© 2014 Microsoft