Uri.Segments Propiedad

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.dll

Obtiene una matriz que contiene los segmentos de ruta de acceso que componen el identificador 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 de propiedad

String[]

Segmentos de ruta de acceso que componen el URI especificado.

Excepciones

InvalidOperationException

Esta instancia representa un identificador URI relativo, y esta propiedad sólo es válida para identificadores URI absolutos.

Ejemplos

En el ejemplo siguiente se crea una Uri instancia con 3 segmentos y se muestran los segmentos en la pantalla.

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

Comentarios

La Segments propiedad devuelve una matriz de cadenas que contienen los "segmentos" (subcadenas) que forman la ruta de acceso absoluta del URI. El primer segmento se obtiene mediante el análisis de la ruta de acceso absoluta desde su primer carácter hasta alcanzar una barra diagonal (/) o el final de la ruta de acceso. Cada segmento adicional comienza en el primer carácter después del segmento anterior y finaliza con la barra diagonal siguiente o el final de la ruta de acceso. (La ruta de acceso absoluta de un URI contiene todo después del host y el puerto y antes de la consulta y el fragmento).

En el ejemplo siguiente se muestra la ruta de acceso absoluta y los segmentos de dos URI. En el segundo ejemplo se muestra que el fragmento y la consulta no forman parte de la ruta de acceso absoluta y, por tanto, no son segmentos.

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

Ruta de acceso absoluta: /Chapter/Chapter1/Sections/Section1.htm

Segmentos:

• /
• Capítulos/
• Capítulo 1/
• Secciones/
• Section1.htm

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

Ruta de acceso absoluta: /Chapter/Chapter1/Sections/Section1.htm

Segmentos:

• /
• Capítulos/
• Capítulo 1/
• Secciones/
• Section1.htm

Tenga en cuenta que, dado que la ruta de acceso absoluta comienza con "/", el primer segmento lo contiene y nada más.