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

Definição

Obtém os componentes especificados da instância atual usando o escape especificado para caracteres especiais.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

Uma combinação bit a bit dos valores UriComponents que especificam quais partes da instância atual a se retornar para o chamador.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

Um dos valores UriFormat que controlam como escapar caracteres especiais.One of the UriFormat values that controls how special characters are escaped.

Retornos

Um String que contém os componentes.A String that contains the components.

Exceções

components não é uma combinação de valores UriComponents válidos.components is not a combination of valid UriComponents values.

O Uri atual não é um URI absoluto.The current Uri is not an absolute URI. Não é possível usar os URIs relativos com este método.Relative URIs cannot be used with this method.

Comentários

Os Querycomponentes Fragment,, Scheme, ,,Hostenãoincluemodelimitador. UserInfo Port PathThe Query, Fragment, Scheme, UserInfo, Host, Port, and Path components do not include the delimiter. Você pode combinar o KeepDelimiter sinalizador (usando o operador OR de bit) com qualquer um desses valores para obter o valor com o 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 os UriComponents outros valores e combinações de valores, os delimitadores são incluídos no valor retornado.For all other UriComponents values, and combinations of values, the delimiters are included in the returned value.

Os componentes são retornados na ordem em que aparecem no URI.The components are returned in the order that they appear in the URI. Por exemplo, se Scheme for especificado, ele aparecerá primeiro.For example, if Scheme is specified, it appears first.

Quando o IRI (identificador de recurso internacional) e o suporte a IDN (nome de domínio internacionalizado) são habilitados, String o número de caracteres retornados aumenta.When International Resource Identifier (IRI) and Internationalized Domain Name (IDN) support are enabled, the number of characters returned in the String increases. Os nomes de Punycode usados para dar suporte a IRI contêm apenas caracteres ASCII e sempre começam com o prefixo xn---.Punycode names used to support IRI contain only ASCII characters and always start with the xn-- prefix. Quando IRI e IDN estão habilitados, os GetComponents caracteres substitutos Unicode são tratados corretamente pelo método.When IRI and IDN are enabled, Unicode surrogate characters are handled correctly by the GetComponents method.

Para obter mais informações sobre o suporte IRI, consulte a seção Comentários da classe Uri.For more information on IRI support, see the Remarks section for the Uri class.

Observação

Se o GetComponents método for chamado com format definido como Unescaped , você não poderá usar o valor de retorno como um argumento Uri para um construtor para criar Urium equivalente.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.

Aplica-se a