URI.ParseServerAuthority 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

嘗試將此 URI 的權威組件（如定義）解析為使用者資訊、主機及埠組件。

[Android.Runtime.Register("parseServerAuthority", "()Ljava/net/URI;", "")]
public Java.Net.URI? ParseServerAuthority();

[<Android.Runtime.Register("parseServerAuthority", "()Ljava/net/URI;", "")>]
member this.ParseServerAuthority : unit -> Java.Net.URI

URI

一個權限欄位被解析為伺服器端權限的 URI

如果權威部分無法解析為伺服器端權威。

嘗試將此 URI 的權威組件（如定義）解析為使用者資訊、主機及埠組件。

如果此 URI 的權威元件已被識別為伺服器端，則它已被解析為使用者資訊、主機與埠元件。在這種情況下，或若該 URI 沒有權威元件，此方法則直接回傳該 URI。

否則，此方法會再次嘗試將權威元件解析為使用者資訊、主機與埠元件，並拋出例外說明為何無法以該方式解析權威元件。

此方法之所以存在，是因為 RFC 2396 中規定的通用 URI 語法無法總是區分錯誤的伺服器端權威與合法的登錄端權威。因此，必須將前者的某些實例視為後者的實例。例如，URI 字串 "//foo:bar"中的權威元件並非合法的伺服器端權威，但作為註冊局基礎的權威是合法的。

在許多常見情況下，例如當處理已知為 URN 或 URL 的 URI，所使用的階層式 URI 總是伺服器端的。因此，它們必須被當作錯誤解析，或視為錯誤。在這種情況下，像這樣的陳述

<Blockquote>URIu= new URI(str).parseServerAuthority();</blockquote>

可用來確保 u 總是指涉一個 URI，若其有權威元件，則擁有伺服器端權威，並具備適當的使用者資訊、主機及埠元件。啟用此方法也確保若無法以該方式解析權威，則能根據拋出的例外發出適當的診斷訊息。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。