ContentResolver.Canonicalize(Uri) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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 。 すべてのリゾルバー呼び出しと同様に、入力には非正規 URI または正規 URI を指定できます。
返品
コンテンツ プロバイダーが指定された URI の正規表現をサポートしていない場合は、 <var>url</var> または null の公式正規表現を返します。 多くのプロバイダーは、一部またはすべての URI の正規化をサポートしていない場合があります。
- 属性
注釈
指定した <var>url</var> を、デバイス間で使用したり、永続化したり、バックアップしたり、復元したりできる、参照されるリソースの正規表現に変換します。返される URI は、コンテンツ プロバイダーで使用できる完全に対応した URI であり、元の URI と同じコンテンツ プロバイダー操作 ( #query、 #openInputStream(android.net.Uri)など) をすべて実行できます。元の URI と新しい URI の動作の唯一の違いは、コンテンツ プロバイダーが、それを使用して適切なリソースに解決するために、各呼び出しで追加の作業を行う必要がある場合があります (特に正規 URI が別の環境に移動されている場合)。
環境間で正規 URI を移動する場合は、元の URI で #canonicalize する別の呼び出しを実行して、現在の環境に対して再正規化する必要があります。 または、 #uncanonicalize を使用して、現在の環境でのみ機能するが、正規表現よりも効率的な可能性がある非正規 URI に変換することもできます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。