Uri.Segments プロパティ

定義

指定した URI を構成するパス セグメントを格納している配列を取得します。Gets an array containing the path segments that make up the specified 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()

プロパティ値

String[]

指定した URI を構成するパス セグメントを格納している String 配列。A String array that contains the path segments that make up the specified URI.

例外

このインスタンスは相対 URI を表します。このプロパティは、絶対 URI でのみ有効です。This instance represents a relative URI, and this property is valid only for absolute URIs.

次の例では、3つのセグメントを持つ Uri インスタンスを作成し、そのセグメントを画面に表示します。The following example creates a Uri instance with 3 segments and displays the segments on the screen.

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

注釈

Segments プロパティは、URI の絶対パスを形成する "セグメント" (部分文字列) を含む文字列の配列を返します。The Segments property returns an array of strings containing the "segments" (substrings) that form the URI's absolute path. 最初のセグメントは、パスのスラッシュ (/) または末尾に達するまで、最初の文字から絶対パスを解析することによって取得されます。The first segment is obtained by parsing the absolute path from its first character until you reach a slash (/) or the end of the path. 各追加セグメントは、前のセグメントの後の最初の文字から始まり、次のスラッシュまたはパスの末尾で終了します。Each additional segment begins at the first character after the preceding segment, and terminates with the next slash or the end of the path. (URI の絶対パスには、ホストとポートの後、クエリとフラグメントの前のすべてが含まれています)。(A URI's absolute path contains everything after the host and port and before the query and fragment.)

次の例は、2つの Uri の絶対パスとセグメントを示しています。The following example shows the absolute path and segments for two URIs. 2番目の例は、フラグメントとクエリが絶対パスの一部ではなく、セグメントではないことを示しています。The second example illustrates that the fragment and query are not part of the absolute path and therefore are not segments.

絶対 URI:Absolute URI:
http://www.contoso.com/Chapters/Chapter1/Sections/Section1.htm

絶対パス:Absolute path:
/Chapters/Chapter1/Sections/Section1.htm/Chapters/Chapter1/Sections/Section1.htm

楕円Segments:

  • /
  • 以降Chapters/
  • Chapter1.txtChapter1/
  • 各項Sections/
  • Section1Section1.htm

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

絶対パス:Absolute path:
/Chapters/Chapter1/Sections/Section1.htm/Chapters/Chapter1/Sections/Section1.htm

楕円Segments:

  • /
  • 以降Chapters/
  • Chapter1.txtChapter1/
  • 各項Sections/
  • Section1Section1.htm

絶対パスは '/' で始まるため、最初のセグメントはそれを含み、それ以外は何も含まれないことに注意してください。Note that because the absolute path starts with a '/', the first segment contains it and nothing else.

適用対象