Uri.GetComponents(UriComponents, UriFormat) Método

Definição

Espaço de Nomes:
System
Assemblagens:
System.dll, System.Runtime.dll
Assemblagem:
System.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
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 UriComponents valores que especifica quais as partes da instância atual a devolver ao chamador.

format
UriFormat

Um dos valores de enumeração que controla como os caracteres especiais são escapados.

Devoluções

String

Os componentes da instância atual.

Exceções

ArgumentOutOfRangeException

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

InvalidOperationException

A corrente Uri não é um URI absoluto. URIs relativas não podem ser usadas com este método.

Observações

Os Querycomponentes , Fragment, Scheme, UserInfo, Host, Port, , e Path não incluem o delimitador. Podes combinar a KeepDelimiter flag (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 devolvido.

Os componentes são devolvidos pela ordem em que aparecem no URI. Por exemplo, se Scheme for especificado, aparece primeiro.

Quando o suporte para Identificador Internacional de Recursos (IRI) e Nome de Domínio Internacionalizado (IDN) são ativados, o número de caracteres devolvidos String aumenta. Os nomes de punycode usados para suportar IRI contêm apenas caracteres ASCII e começam sempre com o prefixo xn--. Quando o IRI e o IDN estão ativados, os caracteres substitutos Unicode são tratados corretamente pelo GetComponents método.

Para mais informações sobre o apoio ao IRI, consulte a secção de Observações da Uri disciplina.

Note

Se o GetComponents método for chamado com format o conjunto em Unescaped , não pode usar o valor de retorno como argumento para um Uri construtor para criar um equivalente Uri.

Aplica-se a