Uri.GetLeftPart-Methode
Gibt den angegebenen Teil einer Uri-Instanz zurück.
Namespace: System
Assembly: System (in system.dll)
Syntax
'Declaration
Public Function GetLeftPart ( _
part As UriPartial _
) As String
'Usage
Dim instance As Uri
Dim part As UriPartial
Dim returnValue As String
returnValue = instance.GetLeftPart(part)
public string GetLeftPart (
UriPartial part
)
public:
String^ GetLeftPart (
UriPartial part
)
public String GetLeftPart (
UriPartial part
)
public function GetLeftPart (
part : UriPartial
) : String
Parameter
- part
Einer der UriPartial-Werte, der den Schlussteil des zurückzugebenden URIs angibt.
Rückgabewert
Ein String, der den angegebenen Teil der Uri-Instanz enthält.
Ausnahmen
Ausnahmetyp | Bedingung |
---|---|
Die aktuelle Uri-Instanz ist keine absolute Instanz. |
|
Der angegebene part ist ungültig. |
Hinweise
Die GetLeftPart-Methode gibt eine Zeichenfolge zurück, die den Anfangsabschnitt der URI-Zeichenfolge bis einschließlich des durch part angegebenen Teils enthält.
GetLeftPart enthält in folgenden Fällen Trennzeichen:
Scheme schließt das Schematrennzeichen ein.
Authority schließt das Pfadtrennzeichen nicht ein.
Path enthält alle Trennzeichen des ursprünglichen URIs bis auf das Abfrage- und das Fragmenttrennzeichen.
Query schließt den Path zusammen mit der Abfrage und dem Trennzeichen ein.
Es folgen Beispiele für einen URI und die Ergebnisse der Aufrufe von GetLeftPart mit Scheme, Authority, Path oder Query.
URI |
Schema |
Authority |
Path |
Query |
---|---|---|---|---|
https://www.contoso.com/index.htm?date=today |
http:// |
https://www.contoso.com |
https://www.contoso.com/index.htm |
https://www.contoso.com/index.htm?date=today |
https://www.contoso.com/index.htm#main |
http:// |
https://www.contoso.com |
https://www.contoso.com/index.htm |
https://www.contoso.com/index.htm |
mailto:user@contoso.com?subject=uri |
mailto: |
mailto:user@contoso.com |
mailto:user@contoso.com?subject=uri |
<Keine> |
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 |
<Keine> |
file://Server/Dateiname.ext |
file:// |
file://Server |
file://Server/Dateiname.ext |
file://Server/Dateiname.ext |
Beispiel
Das folgende Beispiel erstellt eine Uri-Instanz und gibt den Pfad auf der Konsole aus.
' Create Uri
Dim uriAddress As New Uri("https://www.contoso.com/index.htm#search")
Console.WriteLine(uriAddress.Fragment)
Console.WriteLine("Uri {0} the default port ", IIf(uriAddress.IsDefaultPort, "uses", "does not use")) 'TODO: For performance reasons this should be changed to nested IF statements
Console.WriteLine("The path of this Uri is {0}", uriAddress.GetLeftPart(UriPartial.Path))
Console.WriteLine("Hash code {0}", uriAddress.GetHashCode())
// Create Uri
Uri uriAddress = new Uri("https://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());
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0