Uri.GetLeftPart(UriPartial) 方法

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

public string GetLeftPart(UriPartial part);

member this.GetLeftPart : UriPartial -> string

Public Function GetLeftPart (part As UriPartial) As String

參數

傳回

實例中指定的部分 Uri 。

例外狀況

範例

以下範例建立一個 Uri 實例並寫入通往主控台的路徑。

// 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方法等同於使用相應GetComponents旗標呼叫UriComponents。 例如：

• GetLeftPart(UriPartial.Authority) 相當於 GetComponents(UriComponents.Scheme | UriComponents.UserInfo | UriComponents.Host | UriComponents.Port, UriFormat.UriEscaped)

GetLeftPart 以下情況下包含分隔符：

• Scheme 包含方案分隔符。
• Authority 不包含路徑分隔符。
• Path 包含路徑分隔符以及原始 URI 中查詢或片段分隔符中的任何分隔符。
• Query 包含 Path，加上查詢及其分隔符。

以下範例展示了一個 URI 以及呼叫 GetLeftPart 、 SchemeAuthority、 Path或 Query的結果。