Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Uri.GetComponents (UriComponents, UriFormat)

 

Publicado: octubre de 2016

Obtiene los componentes especificados de la instancia actual utilizando las secuencias de escape especificadas para los caracteres especiales.

Espacio de nombres:   System
Ensamblado:  System (en System.dll)

public string GetComponents(
	UriComponents components,
	UriFormat format
)

Parámetros

components
Type: System.UriComponents

Combinación bit a bit de los valores UriComponents que especifica qué partes de la instancia actual se van a devolver al llamador.

format
Type: System.UriFormat

Uno de los valores UriFormat que controla cómo se utiliza una secuencia de escape para los caracteres especiales.

Valor devuelto

Type: System.String

String que contiene los componentes.

Exception Condition
ArgumentOutOfRangeException

componentsno es una combinación de válido UriComponents valores.

InvalidOperationException

Actual Uri no es un URI absoluto. URI relativo no se puede usar con este método.

El Query, Fragment, Scheme, UserInfo, Host, Port, y Path componentes no incluyen el delimitador. Puede combinar el KeepDelimiter marca (mediante el operador OR bit a bit) con cualquiera de esos valores para obtener el valor con el delimitador. Para todos los demás UriComponents valores y combinaciones de valores, los delimitadores se incluyen en el valor devuelto.

Los componentes se devuelven en el orden en que aparecen en el URI. Por ejemplo, si Scheme se especifica, aparece en primer lugar.

Cuando se habilita la compatibilidad de identificadores de recursos internacionales (IRI) y nombre de dominio internacionalizado (IDN), se devuelve el número de caracteres en el String aumenta. Los nombres Punycode utilizados para admitir los IRI contienen únicamente caracteres ASCII y siempre empiezan con el prefijo xn--. Cuando se habilitan IRI e IDN, caracteres suplentes de Unicode se controlan correctamente el GetComponents método.

Para obtener más información sobre la compatibilidad con IRI, vea la sección Comentarios para el Uri clase.

System_CAPS_noteNota

Si el GetComponents método se llama con format establecido en Unescaped , no puede usar el valor devuelto como argumento a un Uri constructor para crear un equivalente Uri.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 2.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: