ContentResolver.Canonicalize(Uri) 方法

定義

命名空間:: Android.Content

組件:: Mono.Android.dll

重要

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

將給定 <的 var>url</var> 轉換成其參考資源的標準表示，該資源可在裝置間使用、持久化、備份與還原等。

[Android.Runtime.Register("canonicalize", "(Landroid/net/Uri;)Landroid/net/Uri;", "")]
public Android.Net.Uri? Canonicalize(Android.Net.Uri url);

[<Android.Runtime.Register("canonicalize", "(Landroid/net/Uri;)Landroid/net/Uri;", "")>]
member this.Canonicalize : Android.Net.Uri -> Android.Net.Uri

參數

url: Uri

Uri該 that 將被轉換為典範表示。如同所有解析器呼叫，輸入可以是非典範或典範 Uri。

傳回

Uri

回傳官方的 var<URL>/var< 標準表示>，若內容提供者不支援該 Uri 的標準表示，則為 null。許多醫療提供者可能不支持部分或全部尿路鏡的標準化。

屬性: RegisterAttribute

備註

將給定 <的 var>url</var> 轉換成其參考資源的標準表示，該資源可在裝置間使用、持久化、備份與還原等。退回的 Uri 仍然是完整功能，可用於其內容提供者，讓你能執行與原始 Uri #query相同的內容提供者操作—— 、 #openInputStream(android.net.Uri)、等等。原始 Uri 與新 Uri 在行為上唯一的差異是，內容提供者可能需要在每次呼叫時額外工作，才能將其解析到正確的資源，尤其是當標準 Uri 已被移至其他環境時。

如果你要在環境間移動一個典型的 Uri，應該對原本的 Uri 進行一次呼叫 #canonicalize ，重新將它重新標準化以適應當前環境。或者，你也可以用 #uncanonicalize 它轉換成一個非正典的 Uri，只在當前環境中運作，但可能比正典表示更有效率。

Java 文件 android.content.ContentResolver.canonicalize(android.net.Uri)。

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

適用於

另請參閱

Uncanonicalize(Uri)