Uri.Segments Propriedade

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

System.dll

Assembly:

netstandard.dll

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

String[]

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

Exceções

InvalidOperationException

Esta instância representa uma URL relativa, e esta propriedade só é válida para URIs absolutos.

Exemplos

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

Uri^ uriAddress1 = gcnew 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 ] );

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 contendo 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é que você alcance uma barra (/) ou o 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 fragmento.)

O exemplo a seguir mostra o caminho e os segmentos absolutos para duas 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/
• Chapter1/
• 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/
• Chapter1/
• Seções/
• Section1.htm

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