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，如果它具有授權元件，則具有具有適當使用者資訊、主機和埠元件的伺服器型授權單位。叫用此方法也可確保如果授權單位無法以這種方式剖析，則可以根據擲回的例外狀況發出適當的診斷訊息。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。