Uri.GetLeftPart(UriPartial) Uri.GetLeftPart(UriPartial) Uri.GetLeftPart(UriPartial) Uri.GetLeftPart(UriPartial) Method

Definición

Obtiene la porción especificada de una instancia de Uri.Gets the specified portion of a Uri instance.

public:
 System::String ^ GetLeftPart(UriPartial part);
public string GetLeftPart (UriPartial part);
member this.GetLeftPart : UriPartial -> string
Public Function GetLeftPart (part As UriPartial) As String

Parámetros

part
UriPartial UriPartial UriPartial UriPartial

Uno de los valores de UriPartial que especifica el final de la porción de identificador URI que se va a devolver.One of the UriPartial values that specifies the end of the URI portion to return.

Devoluciones

String que contiene la porción especificada de la instancia de Uri.A String that contains the specified portion of the Uri instance.

Excepciones

La instancia de Uri actual no es una instancia absoluta.The current Uri instance is not an absolute instance.

El valor especificado en part no es válido.The specified part is not valid.

Ejemplos

En el ejemplo siguiente se crea una instancia de Uri y se escribe la ruta de acceso en la consola.The following example creates a Uri instance and writes the path to the console.

// Create Uri
Uri^ uriAddress = gcnew Uri( "http://www.contoso.com/index.htm#search" );
Console::WriteLine( uriAddress->Fragment );
Console::WriteLine( "Uri {0} the default port ", uriAddress->IsDefaultPort ? (String^)"uses" : "does not use" );

Console::WriteLine( "The path of this Uri is {0}", uriAddress->GetLeftPart( UriPartial::Path ) );
Console::WriteLine( "Hash code {0}", uriAddress->GetHashCode() );
// The example displays the following output:
//        #search
//        Uri uses the default port
//        The path of this Uri is http://www.contoso.com/index.htm
//        Hash code -988419291
// Create Uri
Uri uriAddress = new Uri("http://www.contoso.com/index.htm#search");
Console.WriteLine(uriAddress.Fragment);
Console.WriteLine("Uri {0} the default port ", uriAddress.IsDefaultPort ? "uses" : "does not use");
 
Console.WriteLine("The path of this Uri is {0}", uriAddress.GetLeftPart(UriPartial.Path));
Console.WriteLine("Hash code {0}", uriAddress.GetHashCode());
// The example displays the following output:
//        #search
//        Uri uses the default port
//        The path of this Uri is http://www.contoso.com/index.htm
//        Hash code -988419291
' Create Uri
Dim uriAddress As New Uri("http://www.contoso.com/index.htm#search")
Console.WriteLine(uriAddress.Fragment)
Console.WriteLine("Uri {0} the default port ", If(uriAddress.IsDefaultPort, "uses", "does not use")) 

Console.WriteLine("The path of this Uri is {0}", uriAddress.GetLeftPart(UriPartial.Path))
Console.WriteLine("Hash code {0}", uriAddress.GetHashCode())
' The example displays the following output:
'        #search
'        Uri uses the default port
'        The path of this Uri is http://www.contoso.com/index.htm
'        Hash code -988419291

Comentarios

El método GetLeftPart devuelve una cadena que contiene la parte más a la izquierda de la cadena del URI, terminando con la parte especificada por part.The GetLeftPart method returns a string containing the leftmost portion of the URI string, ending with the portion specified by part.

GetLeftPart incluye delimitadores en los siguientes casos:GetLeftPart includes delimiters in the following cases:

  • Scheme incluye el delimitador de esquema.Scheme includes the scheme delimiter.

  • Authority no incluye el delimitador de ruta de acceso.Authority does not include the path delimiter.

  • Path incluye cualquier delimitador en el URI original hasta el delimitador de la consulta o el fragmento.Path includes any delimiters in the original URI up to the query or fragment delimiter.

  • Query incluye el Path, más la consulta y su delimitador.Query includes the Path, plus the query and its delimiter.

Los ejemplos siguientes muestran un URI y los resultados de llamar a GetLeftPart con Scheme, Authority, Path o Query.The following examples show a URI and the results of calling GetLeftPart with Scheme, Authority, Path, or Query.

Identificador URIURI SchemeScheme Entidad certificaciónAuthority Ruta de accesoPath ConsultaQuery
http://www.contoso.com/index.htm?date=today http:// http://www.contoso.com http://www.contoso.com/index.htm http://www.contoso.com/index.htm?date=today
http://www.contoso.com/index.htm#main http:// http://www.contoso.com http://www.contoso.com/index.htm http://www.contoso.com/index.htm
mailto:user@contoso.com?subject=uri mailto: mailto:user@contoso.com mailto:user@contoso.com?subject=uri <none>
nntp://news.contoso.com/123456@contoso.com nntp:// nntp://news.contoso.com nntp://news.contoso.com/123456@contoso.com nntp://news.contoso.com/123456@contoso.com
news:123456@contoso.com news: news:123456@contoso.com news:123456@contoso.com <none>
file://server/filename.ext file:// file://server file://server/filename.ext file://server/filename.ext

Se aplica a