Uri.GetLeftPart(UriPartial) Método

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

Retornos

A parte especificada da Uri instância.

Exceções

Exemplos

O exemplo a seguir cria uma Uri instância e grava o caminho no console.

// 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 output similar to the following:
//        #search
//        Uri uses the default port
//        The path of this Uri is http://www.contoso.com/index.htm
//        Hash code -988419291

// Create Uri
let uriAddress = Uri "http://www.contoso.com/index.htm#search"
printfn $"{uriAddress.Fragment}"
printfn $"""Uri {if uriAddress.IsDefaultPort then "uses" else "does not use"} the default port """

printfn $"The path of this Uri is {uriAddress.GetLeftPart UriPartial.Path}"
printfn $"Hash code {uriAddress.GetHashCode()}"
// The example displays output similar to the following:
//        #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 output similar to the following:
'        #search
'        Uri uses the default port
'        The path of this Uri is http://www.contoso.com/index.htm
'        Hash code -988419291

Comentários

O GetLeftPart método retorna uma cadeia de caracteres que contém a parte mais à esquerda da cadeia de caracteres URI, terminando com a parte especificada por part.

O GetLeftPart método é equivalente a chamar GetComponents com os sinalizadores apropriados UriComponents . Por exemplo:

• GetLeftPart(UriPartial.Authority) equivale a GetComponents(UriComponents.Scheme | UriComponents.UserInfo | UriComponents.Host | UriComponents.Port, UriFormat.UriEscaped)

GetLeftPart inclui delimitadores nos seguintes casos:

• Scheme inclui o delimitador de esquema.
• Authority não inclui o delimitador de caminho.
• Path inclui o delimitador de caminho e todos os delimitadores no URI original até o delimitador de consulta ou fragmento.
• Query inclui a Pathconsulta e seu delimitador.

Os exemplos a seguir mostram um URI e os resultados da chamada GetLeftPart com Scheme, Authority, ou PathQuery.