Uri.GetComponents(UriComponents, UriFormat) Uri.GetComponents(UriComponents, UriFormat) Uri.GetComponents(UriComponents, UriFormat) Uri.GetComponents(UriComponents, UriFormat) Method

Definición

Obtiene los componentes especificados de la instancia actual utilizando las secuencias de escape especificadas para los caracteres especiales.Gets the specified components of the current instance using the specified escaping for special characters.

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 UriComponents UriComponents UriComponents

Combinación bit a bit de los valores UriComponents que especifica qué partes de la instancia actual se van a devolver al llamador.A bitwise combination of the UriComponents values that specifies which parts of the current instance to return to the caller.

format
UriFormat UriFormat UriFormat UriFormat

Uno de los valores UriFormat que controla cómo se utiliza una secuencia de escape para los caracteres especiales.One of the UriFormat values that controls how special characters are escaped.

Devoluciones

String que contiene los componentes.A String that contains the components.

Excepciones

components no es una combinación de valores de UriComponents válidos.components is not a combination of valid UriComponents values.

El Uri actual no es un identificador URI absoluto.The current Uri is not an absolute URI. Los identificadores URI relativos no se pueden utilizar con este método.Relative URIs cannot be used with this method.

Comentarios

Los Querycomponentes Fragment,, Scheme, UserInfo ,Port, y noPath incluyen el delimitador. HostThe Query, Fragment, Scheme, UserInfo, Host, Port, and Path components do not include the delimiter. Puede combinar la KeepDelimiter marca (mediante el operador OR bit a bit) con cualquiera de esos valores para obtener el valor con el delimitador.You can combine the KeepDelimiter flag (using the bitwise OR operator) with any of those values to get the value with the delimiter. Para todos los UriComponents demás valores y combinaciones de valores, los delimitadores se incluyen en el valor devuelto.For all other UriComponents values, and combinations of values, the delimiters are included in the returned value.

Los componentes se devuelven en el orden en que aparecen en el URI.The components are returned in the order that they appear in the URI. Por ejemplo, si Scheme se especifica, aparece en primer lugar.For example, if Scheme is specified, it appears first.

Cuando se habilita la compatibilidad con el identificador de recursos internacionales (IRI) y el nombre de dominio internacionalizado (IDN), se String aumenta el número de caracteres devueltos.When International Resource Identifier (IRI) and Internationalized Domain Name (IDN) support are enabled, the number of characters returned in the String increases. Los nombres Punycode utilizados para admitir IRI solo contienen caracteres ASCII y siempre comienzan con el prefijo xn--.Punycode names used to support IRI contain only ASCII characters and always start with the xn-- prefix. Cuando se habilitan IRI e IDN, el método controla correctamente los GetComponents caracteres suplentes Unicode.When IRI and IDN are enabled, Unicode surrogate characters are handled correctly by the GetComponents method.

Para obtener más información sobre la compatibilidad con IRI, consulte la sección Uri comentarios de la clase.For more information on IRI support, see the Remarks section for the Uri class.

Nota

Si se GetComponents llama al método con format establecido en Unescaped , no se puede usar el valor devuelto como argumento para Uri un constructor para crear un Uriequivalente.If the GetComponents method is called with format set to Unescaped , you cannot use the return value as an argument to a Uri constructor to create an equivalent Uri.

Se aplica a