Uri.Segments Propriedade

Definição

Obtém um array contendo os segmentos de caminho que compõem o URI especificado.

public:
 property cli::array <System::String ^> ^ Segments { cli::array <System::String ^> ^ get(); };
public string[] Segments { get; }
member this.Segments : string[]
Public ReadOnly Property Segments As String()

Valor de Propriedade

String[]

Os segmentos de caminho que compõem o URI especificado.

Exceções

Esta instância representa um URI relativo, e esta propriedade é válida apenas para URIs absolutos.

Exemplos

O exemplo seguinte cria uma Uri instância com 3 segmentos e mostra os segmentos no ecrã.

Uri uriAddress1 = new Uri("http://www.contoso.com/title/index.htm");
Console.WriteLine("The parts are {0}, {1}, {2}", uriAddress1.Segments[0], uriAddress1.Segments[1], uriAddress1.Segments[2]);
let uriAddress1 = Uri "http://www.contoso.com/title/index.htm"
printfn $"The parts are {uriAddress1.Segments[0]}, {uriAddress1.Segments[1]}, {uriAddress1.Segments[2]}"
Dim uriAddress1 As New Uri("http://www.contoso.com/title/index.htm")
Console.WriteLine("The parts are {0}, {1}, {2}", uriAddress1.Segments(0), uriAddress1.Segments(1), uriAddress1.Segments(2))

Observações

A Segments propriedade devolve um array de cadeias contendo os "segmentos" (subcades) que formam o caminho absoluto do URI. O primeiro segmento é obtido ao analisar o caminho absoluto desde o seu primeiro carácter até se atingir uma barra (/) ou o fim do caminho. Cada segmento adicional começa no primeiro carácter após o segmento anterior e termina com a próxima barra ou o fim do caminho. (O caminho absoluto de um URI contém tudo depois do host e da porta e antes da consulta e fragmento.)

O exemplo seguinte mostra o caminho absoluto e os segmentos para dois URIs. O segundo exemplo ilustra que o fragmento e a consulta não fazem parte do caminho absoluto e, portanto, não são segmentos.

URI absoluto: http://www.contoso.com/Chapters/Chapter1/Sections/Section1.htm

Caminho absoluto: /Capítulos/Capítulo1/Secções/Section1.htm

Segmentos:

  • /
  • Capítulos/
  • Capítulo 1/
  • Secções/
  • Section1.htm

URI absoluto: http://www.contoso.com/Chapters/Chapter1/Sections/Section1.htm#page1?answer=NO

Caminho absoluto: /Capítulos/Capítulo1/Secções/Section1.htm

Segmentos:

  • /
  • Capítulos/
  • Capítulo 1/
  • Secções/
  • Section1.htm

Note-se que, como o caminho absoluto começa com '/', o primeiro segmento o contém e nada mais.

Aplica-se a