Uri.GetLeftPart(UriPartial) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém a parte especificada de uma Uri instância.
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
Um dos valores de enumeração que especifica o fim da parte do URI a devolver.
Devoluções
A parte especificada da Uri instância.
Exceções
A instância atual Uri não é uma instância absoluta.
O especificado part não é válido.
Exemplos
O exemplo seguinte cria uma Uri instância e escreve o caminho até à consola.
// 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
Observações
O GetLeftPart método devolve uma cadeia contendo a porção mais à esquerda da cadeia URI, terminando na parte especificada por part.
Importante
O GetLeftPart método realiza a codificação e normalização de caracteres Unicode como parte do seu processamento. Não é um método simples de manipulação de cadeias. A cadeia devolvida pode diferir da cadeia URI original devido a este comportamento de codificação.
O GetLeftPart método é equivalente a chamar GetComponents com as flags apropriadas UriComponents . Por exemplo:
a..é equivalente aa..^0
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 quaisquer delimitadores no URI original até ao delimitador de consulta ou fragmento.
- Query inclui o Path, mais a consulta e o seu delimitador.
Os exemplos seguintes mostram um URI e os resultados de chamar GetLeftPart com Scheme, Authority, Path, ou Query.
| URI | Scheme | Autoridade | Caminho | Query |
|---|---|---|---|---|
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: |
<none> |
mailto:user@contoso.com |
mailto:user@contoso.com?subject=uri |
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: |
<none> |
news:123456@contoso.com |
news:123456@contoso.com |
file://server/filename.ext |
file:// |
file://server |
file://server/filename.ext |
file://server/filename.ext |