Langue

ContentResolver.Canonicalize(Uri) Méthode

Définition

Transformez l’URL</var var>< donnée >en une représentation canonique de sa ressource référencée, qui peut être utilisée sur les appareils, conservée, sauvegardée et restaurée, etc.

[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

Paramètres

url
Uri

Celui Uri qui doit être transformé en représentation canonique. Comme tous les appels de programme de résolution, l’entrée peut être un URI non canonique ou canonique.

Retours

Uri

Retourne la représentation canonique officielle de <var url>/var<>, ou null si le fournisseur de contenu ne prend pas en charge une représentation canonique de l’URI donné. De nombreux fournisseurs peuvent ne pas prendre en charge la canonisation d’une partie ou de l’ensemble de leurs URI.

Attributs

Remarques

Transformez l’URL</var var>< donnée >en une représentation canonique de sa ressource référencée, qui peut être utilisée sur les appareils, conservée, sauvegardée et restaurée, etc. L’URI retourné est toujours un URI entièrement compatible à utiliser avec son fournisseur de contenu, ce qui vous permet d’effectuer toutes les mêmes opérations de fournisseur de contenu que avec l’URI d’origine - #query, #openInputStream(android.net.Uri)etc. La seule différence de comportement entre les URI d’origine et les nouveaux URI est que le fournisseur de contenu peut avoir besoin d’effectuer un travail supplémentaire à chaque appel en l’utilisant pour le résoudre vers la ressource correcte, en particulier si l’URI canonique a été déplacé vers un autre environnement.

Si vous déplacez un URI canonique entre les environnements, vous devez effectuer un autre appel avec #canonicalize cet URI d’origine pour le re canoniser pour l’environnement actuel. Vous pouvez également utiliser #uncanonicalize pour la transformer en uri non canonique qui fonctionne uniquement dans l’environnement actuel, mais potentiellement plus efficace que la représentation canonique.

Java documentation pour android.content.ContentResolver.canonicalize(android.net.Uri).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à

Voir aussi