Uri.GetComponents(UriComponents, UriFormat) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> stringPublic Function GetComponents (components As UriComponents, format As UriFormat) As StringPará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
Componentes de la instancia actual.
Excepciones
components no es una combinación de valores de UriComponents válidos.
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.