Uri.GetComponents(UriComponents, UriFormat) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> stringPublic Function GetComponents (components As UriComponents, format As UriFormat) As StringParâ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
Os componentes da instância atual.
Exceções
components não é uma combinação de valores UriComponents válidos.
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.