Uri.Segments Uri.Segments Uri.Segments Uri.Segments Property

Definición

Obtiene una matriz que contiene los segmentos de ruta de acceso que componen el identificador URI especificado.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()

Valor de propiedad

String[]

Matriz de String que contiene los segmentos de ruta de acceso que componen el identificador URI especificado.A String array that contains the path segments that make up the specified URI.

Excepciones

Esta instancia representa un identificador URI relativo, y esta propiedad sólo es válida para identificadores URI absolutos.This instance represents a relative URI, and this property is valid only for absolute URIs.

Ejemplos

En el ejemplo siguiente se Uri crea una instancia de con 3 segmentos y se muestran los segmentos en la pantalla.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))

Comentarios

La Segments propiedad devuelve una matriz de cadenas que contiene los "segmentos" (subcadenas) que forman la ruta de acceso absoluta del URI.The Segments property returns an array of strings containing the "segments" (substrings) that form the URI's absolute path. El primer segmento se obtiene analizando la ruta de acceso absoluta desde su primer carácter hasta que llegue a una barra diagonal (/) o al final de la ruta de acceso.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. Cada segmento adicional comienza en el primer carácter después del segmento anterior y termina con la barra diagonal siguiente o el final de la ruta de acceso.Each additional segment begins at the first character after the preceding segment, and terminates with the next slash or the end of the path. (La ruta de acceso absoluta de un URI contiene todo lo que se encuentra después del host y el puerto, y antes de la consulta y el fragmento).(A URI's absolute path contains everything after the host and port and before the query and fragment.)

En el ejemplo siguiente se muestra la ruta de acceso absoluta y los segmentos de dos identificadores URI.The following example shows the absolute path and segments for two URIs. En el segundo ejemplo se muestra que el fragmento y la consulta no forman parte de la ruta de acceso absoluta y, por lo tanto, no son segmentos.The second example illustrates that the fragment and query are not part of the absolute path and therefore are not segments.

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

Ruta de acceso absoluta:Absolute path:
/Chapters/Chapter1/Sections/Section1.htm/Chapters/Chapter1/Sections/Section1.htm

SectoresSegments:

  • /
  • ComplementaChapters/
  • Archivo chapter1Chapter1/
  • SecciónSections/
  • Section1. htmSection1.htm

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

Ruta de acceso absoluta:Absolute path:
/Chapters/Chapter1/Sections/Section1.htm/Chapters/Chapter1/Sections/Section1.htm

SectoresSegments:

  • /
  • ComplementaChapters/
  • Archivo chapter1Chapter1/
  • SecciónSections/
  • Section1. htmSection1.htm

Tenga en cuenta que, dado que la ruta de acceso absoluta comienza con '/', el primer segmento lo contiene y nada más.Note that because the absolute path starts with a '/', the first segment contains it and nothing else.

Se aplica a