Uri.GetLeftPart(UriPartial) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

Uri.cs

Örneğin Uri belirtilen bölümünü alır.

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

public string GetLeftPart(UriPartial part);

member this.GetLeftPart : UriPartial -> string

Public Function GetLeftPart (part As UriPartial) As String

Parametreler

part

UriPartial

Döndürülecek URI bölümünün sonunu belirten numaralandırma değerlerinden biri.

Döndürülenler

String

Örneğin belirtilen bölümü Uri .

Özel durumlar

InvalidOperationException

Geçerli Uri örnek mutlak bir örnek değil.

ArgumentException

Belirtilen part geçerli değil.

Örnekler

Aşağıdaki örnek bir Uri örnek oluşturur ve konsol yolunu yazar.

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

Açıklamalar

yöntemi, GetLeftPart URI dizesinin en soldaki bölümünü içeren ve tarafından partbelirtilen bölümüyle biten bir dize döndürür.

Important

yöntemi, GetLeftPart işlemesinin bir parçası olarak Unicode karakter kodlama ve normalleştirme gerçekleştirir. Basit bir dize işleme yöntemi değildir. Döndürülen dize, bu kodlama davranışı nedeniyle özgün URI dizesinden farklı olabilir.

GetLeftPart yöntemi, uygun GetComponents bayraklarla çağrılmaya UriComponents eşdeğerdir. Örneğin:

• GetLeftPart(UriPartial.Authority) eşdeğerdir GetComponents(UriComponents.Scheme | UriComponents.UserInfo | UriComponents.Host | UriComponents.Port, UriFormat.UriEscaped)

GetLeftPart aşağıdaki durumlarda sınırlayıcıları içerir:

• Scheme şema sınırlayıcısını içerir.
• Authority yol sınırlayıcısını içermez.
• Path , özgün URI'deki yol sınırlayıcısını ve sorguya veya parça sınırlayıcıya kadar sınırlayıcıları içerir.
• Query Path, artı sorgusunu ve sınırlayıcısını içerir.

Aşağıdaki örneklerde bir URI ve ile çağrının GetLeftPartSchemesonuçları gösterilir. AuthorityPathQuery

URI	Scheme	Yetkili	Yol	Query
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