Uri.GetLeftPart(UriPartial) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

Source:

Uri.cs

取得 Uri 執行個體的指定部分。

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

public string GetLeftPart (UriPartial part);

member this.GetLeftPart : UriPartial -> string

Public Function GetLeftPart (part As UriPartial) As String

參數

part

UriPartial

其中一個列舉值，其指定要傳回之 URI 部分的結尾。

傳回

String

Uri 執行個體的指定部分。

例外狀況

InvalidOperationException

目前的 Uri 執行個體不是絕對執行個體。

ArgumentException

指定的 part 無效。

範例

下列範例會 Uri 建立 實例，並將路徑寫入主控台。

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

備註

方法 GetLeftPart 會傳回包含 URI 字串最左邊部分的字串，結尾為 所 part 指定的部分。

GetLeftPart 在下列情況下包含分隔符號：

• Scheme 包含配置分隔符號。
• Authority 不包含路徑分隔符號。
• Path 包含原始 URI 中路徑分隔符號和任何分隔符號，以及查詢或片段分隔符號為止。
• QueryPath包含 ，加上查詢及其分隔符號。

下列範例示範使用 、 Authority 、 Path 或 Query 呼叫 GetLeftPartScheme 的 URI 和結果。

URI	配置	授權單位	路徑	查詢
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