Uri.GetLeftPart(UriPartial) Uri.GetLeftPart(UriPartial) Uri.GetLeftPart(UriPartial) Uri.GetLeftPart(UriPartial) Method

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 UriPartial UriPartial 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

Das folgende Beispiel erstellt eine Uri -Instanz und den 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, die mit den am weitesten links stehende Teil der URI-Zeichenfolge vom angegebenen Teils part.The GetLeftPart method returns a string containing the leftmost portion of the URI string, ending with the portion specified by part.

GetLeftPart enthält die Trennzeichen in den folgenden Fällen:GetLeftPart includes delimiters in the following cases:

  • Scheme Schließt das Schematrennzeichen an.Scheme includes the scheme delimiter.

  • Authority umfasst nicht das Pfadtrennzeichen.Authority does not include the path delimiter.

  • Path enthält alle Trennzeichen in den ursprünglichen URI bis zu der Abfrage oder Fragment-Trennzeichen.Path includes any delimiters in the original URI up to the query or fragment delimiter.

  • Query enthält die Path, sowie die Abfrage und dem Trennzeichen.Query includes the Path, plus the query and its delimiter.

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

URIURI SchemaScheme ZertifizierungsstelleAuthority PfadPath AbfrageQuery
http://www.contoso.com/index.htm?date=today http://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:// http://www.contoso.com http://www.contoso.com/index.htm http://www.contoso.com/index.htm
mailto:user@contoso.com?subject=urimailto:user@contoso.com?subject=uri mailto:mailto: mailto:user@contoso.com mailto:user@contoso.com?subject=urimailto:user@contoso.com?subject=uri <none><none>
nntp://news.contoso.com/123456@contoso.com nntp://nntp:// nntp://news.contoso.comnntp://news.contoso.com nntp://news.contoso.com/123456@contoso.com nntp://news.contoso.com/123456@contoso.com
news:123456@contoso.com Neuigkeiten:news: news:123456@contoso.com news:123456@contoso.com <none><none>
file://server/filename.extfile://server/filename.ext file://file:// file://Serverfile://server file://server/filename.extfile://server/filename.ext file://server/filename.extfile://server/filename.ext

Gilt für: