Uri.GetLeftPart(UriPartial) Methode

Definition

Ruft den angegebenen Teil einer Uri-Instanz ab.Gets the specified portion of a Uri instance.

public:
 System::String ^ GetLeftPart(UriPartial part);
public string GetLeftPart (UriPartial part);
member this.GetLeftPart : UriPartial -> string
Public Function GetLeftPart (part As UriPartial) As String

Parameter

part
UriPartial

Einer der UriPartial-Werte, der den Schlussteil des zurückzugebenden URIs angibt.One of the UriPartial values that specifies the end of the URI portion to return.

Gibt zurück

Ein String, der den angegebenen Teil der Uri-Instanz enthält.A String that contains the specified portion of the Uri instance.

Ausnahmen

Die aktuelle Uri-Instanz ist keine absolute Instanz.The current Uri instance is not an absolute instance.

Der angegebene part ist ungültig.The specified part is not valid.

Beispiele

Im folgenden Beispiel wird eine Uri Instanz erstellt und der Pfad in die Konsole geschrieben.The following example creates a Uri instance and writes the path to the console.

// Create Uri
Uri^ uriAddress = gcnew Uri( "http://www.contoso.com/index.htm#search" );
Console::WriteLine( uriAddress->Fragment );
Console::WriteLine( "Uri {0} the default port ", uriAddress->IsDefaultPort ? (String^)"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 the following output:
//        #search
//        Uri uses the default port
//        The path of this Uri is http://www.contoso.com/index.htm
//        Hash code -988419291
// 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 the following output:
//        #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 the following output:
'        #search
'        Uri uses the default port
'        The path of this Uri is http://www.contoso.com/index.htm
'        Hash code -988419291

Hinweise

Die GetLeftPart-Methode gibt eine Zeichenfolge zurück, die den äußersten linken Teil der URI-Zeichenfolge enthält, und endet mit dem durch partangegebenen Teil.The GetLeftPart method returns a string containing the leftmost portion of the URI string, ending with the portion specified by part.

GetLeftPart umfasst in den folgenden Fällen Trennzeichen:GetLeftPart includes delimiters in the following cases:

  • Scheme schließt das Schema Trennzeichen ein.Scheme includes the scheme delimiter.

  • in Authority ist das Pfad Trennzeichen nicht enthalten.Authority does not include the path delimiter.

  • Path schließt alle Trennzeichen im ursprünglichen URI bis zum Abfrage-oder Fragmenttrennzeichen ein.Path includes any delimiters in the original URI up to the query or fragment delimiter.

  • Query enthält die Pathsowie die Abfrage und das zugehörige Trennzeichen.Query includes the Path, plus the query and its delimiter.

Die folgenden Beispiele zeigen einen URI und die Ergebnisse des Aufrufs von GetLeftPart mit Scheme, Authority, Pathoder Query.The following examples show a URI and the results of calling GetLeftPart with Scheme, Authority, Path, or Query.

URIURI SchemaScheme HerrschaftAuthority PfadPath AbfrageQuery
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: mailto:user@contoso.com mailto:user@contoso.com?subject=uri <none>
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 <none>
file://server/filename.ext file:// file://server file://server/filename.ext file://server/filename.ext

Gilt für: