Uri.GetLeftPart(UriPartial) Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

Uri.cs

Pobiera określoną część Uri wystąpienia.

public:
 System::String ^ GetLeftPart(UriPartial part);

public string GetLeftPart (UriPartial part);

member this.GetLeftPart : UriPartial -> string

Public Function GetLeftPart (part As UriPartial) As String

Parametry

part

UriPartial

Jedna z wartości wyliczenia, która określa koniec części identyfikatora URI do zwrócenia.

Zwraca

String

Określona część Uri wystąpienia.

Wyjątki

InvalidOperationException

Bieżące Uri wystąpienie nie jest wystąpieniem bezwzględnym.

ArgumentException

Określony part parametr jest nieprawidłowy.

Przykłady

Poniższy przykład tworzy Uri wystąpienie i zapisuje ścieżkę do konsoli.

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

Uwagi

Metoda GetLeftPart zwraca ciąg zawierający najbardziej lewą część ciągu identyfikatora URI kończący się częścią określoną przez part.

GetLeftPart zawiera ograniczniki w następujących przypadkach:

• Scheme zawiera ogranicznik schematu.
• Authority nie zawiera ogranicznika ścieżki.
• Path zawiera ogranicznik ścieżki i wszelkie ograniczniki w oryginalnym identyfikatorze URI aż do ogranicznika zapytania lub fragmentu.
• Query zawiera element Path, plus zapytanie i jego ogranicznik.

W poniższych przykładach pokazano identyfikator URI i wyniki wywołania za GetLeftPart pomocą Schememetody , Authority, Pathlub Query.

URI	Schemat	Urząd	Ścieżka	Zapytanie
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