Uri Class

Analiza identificadores uniformes de recursos (URI).

.NET:  Este tipo aparece como System.Uri.

Sintaxis


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

Atributos

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

Members

A continuación se indican los tipos de miembros de Uri (Clase):

Constructores

A continuación se indican los constructores de Uri (Clase).

ConstructorDescripción
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étodos

The Uri Clase tiene estos métodos. Con C#, Visual Basic y C++, también hereda métodos de Object Clase.

MétodoDescripción
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.

 

Propiedades

UriClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

AbsoluteCanonicalUri

De sólo lecturaGets a fully canonicalized RFC-complaint representation of the current URI.

AbsoluteUri

De sólo lecturaGets the entire, non-canonical IRI.

DisplayIri

De sólo lecturaGets the decoded unicode characters that make up the current URI.

DisplayUri

De sólo lecturaGets a representation of the IRI that can be used for display purposes.

Domain

De sólo lecturaGets the domain name, including top-level domain, from a Uniform Resource Identifier (URI).

Extension

De sólo lecturaGets the file name extension of the resource that is referenced in the Uniform Resource Identifier (URI).

Fragment

De sólo lecturaGets the text following a fragment marker (#), including the fragment marker itself.

Host

De sólo lecturaGets the fully qualified domain name.

Password

De sólo lecturaGets the password, as parsed from a Uniform Resource Identifier (URI).

Path

De sólo lecturaGets the path and resource name.

Port

De sólo lecturaGets the port number.

Query

De sólo lecturaGets the query string.

QueryParsed

De sólo lecturaGets a parsed URL query string.

RawUri

De sólo lecturaGets the entire original Uniform Resource Identifier (URI) string.

SchemeName

De sólo lecturaGets the protocol scheme name.

Suspicious

De sólo lecturaGets a value that indicates whether the Uniform Resource Identifier (URI) is not well-formed.

UserName

De sólo lecturaGets the user name as parsed from a Uniform Resource Identifier (URI).

 

Comentarios

Al compilar aplicaciones de la Tienda Windows con Microsoft .NET Framework, se oculta esta clase y los programadores deben utilizar la clase System.Uri, que utiliza RFC 3987 para codificar y descodificar identificadores URI. La clase Uri no codifica con porcentajes los caracteres no ASCII de los URI de file:// e interpreta la codificación con porcentajes mediante la página de códigos actual del usuario.

A continuación se muestra un desglose de las partes de un URI de ejemplo:

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

Por ejemplo:

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

En este ejemplo:

  • scheme es ftp
  • host es ftp.microsoft.com
  • domain es microsoft.com (un subconjunto de host)
  • port es 8080
  • extension es asp

Ejemplos

Este ejemplo crea un URI que usa el protocolo HTTP para tener acceso a un sitio 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);

Este ejemplo crea un URI que usa el protocolo ms-appx para tener acceso a un archivo de imagen en el paquete de la aplicación.


// 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);

Este ejemplo crea un URI que usa el protocolo ms-appdata para tener acceso a un archivo en el almacén local para la aplicación.


// 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);

Requisitos

Cliente mínimo admitido

Windows 8 [Aplicaciones de la Tienda Windows, aplicaciones de escritorio]

Servidor mínimo admitido

Windows Server 2012 [Aplicaciones de la Tienda Windows, aplicaciones de escritorio]

Teléfono mínimo admitido

Windows Phone 8

Espacio de nombres

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

Metadatos

Windows.winmd

Vea también

Cómo hacer referencia a un contenido

 

 

Mostrar:
© 2015 Microsoft