語言

ContentProvider.Canonicalize(Uri) 方法

定義

命名空間:
Android.Content
組件:
Mono.Android.dll

實作此功能以支援指向你內容提供者的 URI 的標準化。

[Android.Runtime.Register("canonicalize", "(Landroid/net/Uri;)Landroid/net/Uri;", "GetCanonicalize_Landroid_net_Uri_Handler")]
public virtual Android.Net.Uri? Canonicalize(Android.Net.Uri url);
[<Android.Runtime.Register("canonicalize", "(Landroid/net/Uri;)Landroid/net/Uri;", "GetCanonicalize_Landroid_net_Uri_Handler")>]
abstract member Canonicalize : Android.Net.Uri -> Android.Net.Uri
override this.Canonicalize : Android.Net.Uri -> Android.Net.Uri

參數

url
Uri

烏里族將被正典化。

傳回

Uri

回傳 var<url>/var< 的標準表示>，若不支援該 Uri 的正則化，則回傳 null。

屬性
RegisterAttribute

備註

實作此功能以支援指向你內容提供者的 URI 的標準化。 標準 URI 是指能夠跨裝置傳輸、備份/還原及其他情境，且仍能指向同一資料項目的 URI。 通常透過在 URI 中加入查詢參數來實現，讓內容提供者能驗證接收的標準 URI 是否參考了它原本預期的資料，若不符合，則在當前環境中尋找該資料（若存在）。

例如，如果內容提供者儲存了人，並且在其中建立了一個普通的 URI，並用列索引進入該人物資料庫，那麼 cananical 表示法的末尾可能會有一個額外的查詢參數，指定它所指派的人物名稱。 之後用該 URI 呼叫提供者時，會查詢該 URI 基礎索引的哪一列，如果與查詢參數中的名稱不符或條目名稱不符，則對其資料庫進行查詢，找出正確的行來操作。

如果你實作對標準 URI 的支援，<><所有/所有>來電（包括這個 URI）必須對收到的任何標準 URI 進行驗證與恢復。 此外，你還必須實施 #uncanonicalize 剝除這些 URI 的正典化。

此方法的預設實作回傳 null，表示不支援標準 URI。

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

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

適用於