ContentResolver.Canonicalize(Uri) Metodo

Definizione

Trasformare l'URL</var>> specificato <in una rappresentazione canonica della risorsa a cui si fa riferimento, che può essere usata tra dispositivi, salvati in modo permanente, sottoposto a backup e ripristino e così via.

[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

Parametri

url
Uri

Oggetto Uri da trasformare in una rappresentazione canonica. Analogamente a tutte le chiamate del resolver, l'input può essere un URI non canonico o canonico.

Valori restituiti

Uri

Restituisce la rappresentazione canonica ufficiale di <var>url</var> o null se il provider di contenuti non supporta una rappresentazione canonica dell'URI specificato. Molti provider potrebbero non supportare la canonizzazione di alcuni o tutti i relativi URI.

Attributi

Commenti

Trasformare l'URL</var>> specificato <in una rappresentazione canonica della risorsa a cui si fa riferimento, che può essere usata tra dispositivi, salvati in modo permanente, sottoposto a backup e ripristino e così via. L'URI restituito è ancora un URI completamente idoneo per l'uso con il provider di contenuti, consentendo di eseguire tutte le stesse operazioni del provider di contenuti come con l'URI originale - #query, e #openInputStream(android.net.Uri)così via. L'unica differenza nel comportamento tra gli URI originali e nuovi consiste nel fatto che il provider di contenuti potrebbe dover eseguire alcune operazioni aggiuntive in ogni chiamata usandola per risolverlo nella risorsa corretta, soprattutto se l'URI canonico è stato spostato in un ambiente diverso.

Se si sposta un URI canonico tra ambienti, è necessario eseguire un'altra chiamata a #canonicalize con tale URI originale per ri-canonizzarlo per l'ambiente corrente. In alternativa, è possibile usare #uncanonicalize per trasformarlo in un URI non canonico che funziona solo nell'ambiente corrente, ma potenzialmente più efficiente rispetto alla rappresentazione canonica.

per android.content.ContentResolver.canonicalize(android.net.Uri).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a

Vedi anche