Uri.GetComponents(UriComponents, UriFormat) Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Obtém os componentes especificados da instância atual usando o escape especificado para caracteres especiais.

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

Uma combinação bit a bit dos valores UriComponents que especificam quais partes da instância atual a se retornar para o chamador.

format

UriFormat

Um dos valores de enumeração que controla como aplicar escape aos caracteres especiais.

Retornos

String

Os componentes da instância atual.

Exceções

ArgumentOutOfRangeException

components não é uma combinação de valores UriComponents válidos.

InvalidOperationException

O Uri atual não é um URI absoluto. Não é possível usar os URIs relativos com este método.

Comentários

Os Querycomponentes , Fragment, Schemee PortUserInfoHostPath , não incluem o delimitador. Você pode combinar o KeepDelimiter sinalizador (usando o operador OR bit a bit) com qualquer um desses valores para obter o valor com o delimitador. Para todos os outros UriComponents valores e combinações de valores, os delimitadores são incluídos no valor retornado.

Os componentes são retornados na ordem em que aparecem no URI. Por exemplo, se Scheme for especificado, ele será exibido primeiro.

Quando o IRI (International Resource Identifier) e o suporte ao IDN (Nome de Domínio Internacionalizado) são habilitados, o número de caracteres retornados nos String aumentos. Os nomes punycode usados para dar suporte à IRI contêm apenas caracteres ASCII e sempre começam com o prefixo xn--. Quando IRI e IDN estão habilitados, os caracteres alternativos Unicode são tratados corretamente pelo GetComponents método.

Para obter mais informações sobre o suporte IRI, consulte a seção Comentários da classe Uri.

Observação

Se o GetComponents método for chamado com format set to Unescaped , você não poderá usar o valor retornado como um argumento para um Uri construtor para criar um equivalente Uri.