Freigeben über


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

InvalidOperationException

Die aktuelle Uri-Instanz ist keine absolute Instanz.

ArgumentException

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

Siehe auch

Referenz

Uri-Klasse
Uri-Member
System-Namespace