Uri.GetComponents(UriComponents, UriFormat) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.dll

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

public:
 System::String ^ GetComponents(UriComponents components, UriFormat format);

public string GetComponents (UriComponents components, UriFormat format);

member this.GetComponents : UriComponents * UriFormat -> string

Public Function GetComponents (components As UriComponents, format As UriFormat) As String

Parámetros

components

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

UriFormat

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

Devoluciones

String

Componentes de la instancia actual.

Excepciones

ArgumentOutOfRangeException

components no es una combinación de valores de UriComponents válidos.

InvalidOperationException

El Uri actual no es un identificador URI absoluto. Los identificadores URI relativos no se pueden utilizar con este método.

Comentarios

Los Querycomponentes , Fragment, SchemeUserInfo, Host, Port, y Path no incluyen el delimitador. Puede combinar la 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 primero.

Cuando se habilita la compatibilidad con el identificador de recursos internacional (IRI) y el nombre de dominio internacionalizado (IDN), el número de caracteres devueltos en los String aumentos. Los nombres punycode usados para admitir IRI solo contienen caracteres ASCII y siempre comienzan con el prefijo xn-- . Cuando se habilitan IRI e IDN, el método controla correctamente los GetComponents caracteres suplentes Unicode.

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

Nota

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