Uri.Segments Właściwość

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Zestaw:

System.dll

Zestaw:

netstandard.dll

Pobiera tablicę zawierającą segmenty ścieżki tworzące określony identyfikator URI.

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

Wartość właściwości

String[]

Segmenty ścieżki tworzące określony identyfikator URI.

Wyjątki

InvalidOperationException

To wystąpienie reprezentuje względny identyfikator URI, a ta właściwość jest prawidłowa tylko dla bezwzględnych identyfikatorów URI.

Przykłady

Poniższy przykład tworzy Uri wystąpienie z 3 segmentami i wyświetla segmenty na ekranie.

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

Uwagi

Właściwość Segments zwraca tablicę ciągów zawierających "segmenty" (podciągów), które tworzą ścieżkę bezwzględną identyfikatora URI. Pierwszy segment jest uzyskiwany przez analizowanie ścieżki bezwzględnej od pierwszego znaku do momentu osiągnięcia ukośnika (/) lub końca ścieżki. Każdy dodatkowy segment zaczyna się od pierwszego znaku po poprzednim segmencie i kończy się następnym ukośnikiem lub końcem ścieżki. (Ścieżka bezwzględna identyfikatora URI zawiera wszystko po hoście i porcie oraz przed zapytaniem i fragmentem).

W poniższym przykładzie przedstawiono ścieżkę bezwzględną i segmenty dla dwóch identyfikatorów URI. Drugi przykład ilustruje, że fragment i zapytanie nie są częścią ścieżki bezwzględnej i dlatego nie są segmentami.

Bezwzględny identyfikator URI: http://www.contoso.com/Chapters/Chapter1/Sections/Section1.htm

Ścieżka bezwzględna: /Rozdziały/Rozdział1/Sekcje/Section1.htm

Segmenty:

• /
• Rozdziały/
• Rozdział1/
• Sekcje/
• Section1.htm

Bezwzględny identyfikator URI: http://www.contoso.com/Chapters/Chapter1/Sections/Section1.htm#page1?answer=NO

Ścieżka bezwzględna: /Rozdziały/Rozdział1/Sekcje/Section1.htm

Segmenty:

• /
• Rozdziały/
• Rozdział1/
• Sekcje/
• Section1.htm

Należy pamiętać, że ponieważ ścieżka bezwzględna zaczyna się od "/", pierwszy segment zawiera go i nic innego.