Uri.Segments Propriedade

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Origem:

Uri.cs

Obtém uma matriz que contém 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 da propriedade

String[]

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

Exceções

InvalidOperationException

Essa instância representa um URI relativo e essa propriedade é válida apenas para URIs absolutas.

Exemplos

O exemplo a seguir cria uma Uri instância com três segmentos e exibe os segmentos na tela.

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))

Comentários

A Segments propriedade retorna uma matriz de cadeias de caracteres que contêm os "segmentos" (subcadeias de caracteres) que formam o caminho absoluto do URI. O primeiro segmento é obtido analisando o caminho absoluto de seu primeiro caractere até chegar a uma barra (/) ou ao final do caminho. Cada segmento adicional começa no primeiro caractere após o segmento anterior e termina com a próxima barra ou o final do caminho. (O caminho absoluto de um URI contém tudo após o host e a porta e antes da consulta e do fragmento.)

O exemplo a seguir 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: /Chapters/Chapter1/Sections/Section1.htm

Segmentos:

• /
• Capítulos/
• Capítulo1/
• Seções/
• Section1.htm

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

Caminho absoluto: /Chapters/Chapter1/Sections/Section1.htm

Segmentos:

• /
• Capítulos/
• Capítulo1/
• Seções/
• Section1.htm

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