Uri.GetLeftPart(UriPartial) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u het opgegeven gedeelte van een Uri exemplaar op.
public:
System::String ^ GetLeftPart(UriPartial part);
public string GetLeftPart(UriPartial part);
member this.GetLeftPart : UriPartial -> string
Public Function GetLeftPart (part As UriPartial) As String
Parameters
- part
- UriPartial
Een van de opsommingswaarden die het einde van het URI-gedeelte aangeeft dat moet worden geretourneerd.
Retouren
Het opgegeven gedeelte van het Uri exemplaar.
Uitzonderingen
Het huidige Uri exemplaar is geen absoluut exemplaar.
De opgegeven part waarde is ongeldig.
Voorbeelden
In het volgende voorbeeld wordt een Uri exemplaar gemaakt en wordt het pad naar de console geschreven.
// 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
Opmerkingen
De GetLeftPart methode retourneert een tekenreeks die het meest linkse gedeelte van de URI-tekenreeks bevat, eindigend met het gedeelte dat is opgegeven door part.
Important
De GetLeftPart methode voert Unicode-tekencodering en normalisatie uit als onderdeel van de verwerking. Het is geen eenvoudige methode voor het bewerken van tekenreeksen. De geretourneerde tekenreeks kan verschillen van de oorspronkelijke URI-tekenreeks vanwege dit coderingsgedrag.
De GetLeftPart methode is gelijk aan het aanroepen GetComponents met de juiste UriComponents vlaggen. Voorbeeld:
-
GetLeftPart(UriPartial.Authority)is gelijk aanGetComponents(UriComponents.Scheme | UriComponents.UserInfo | UriComponents.Host | UriComponents.Port, UriFormat.UriEscaped)
GetLeftPart bevat scheidingstekens in de volgende gevallen:
- Scheme bevat het scheidingsteken voor schema's.
- Authority bevat het padscheidingsteken niet.
- Path bevat het padscheidingsteken en eventuele scheidingstekens in de oorspronkelijke URI tot aan het query- of fragmentscheidingsteken.
- Query bevat de Path, plus de query en het scheidingsteken.
In de volgende voorbeelden ziet u een URI en de resultaten van het aanroepen GetLeftPart met Scheme, Authorityof PathQuery.
| URI | Scheme | Autoriteit | Pad | 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 |