ContentProvider.Canonicalize(Uri) Metodo

Definizione

Spazio dei nomi:: Android.Content

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Implementare questa opzione per supportare la canonizzazione degli URI che fanno riferimento al provider di contenuti.

[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

Parametri

url: Uri

Uri da canonizzare.

Valori restituiti

Uri

Restituisce la rappresentazione canonica di <var>url</var> o null se la canonizzazione di tale URI non è supportata.

Attributi: RegisterAttribute

Commenti

Implementare questa opzione per supportare la canonizzazione degli URI che fanno riferimento al provider di contenuti. Un URI canonico è un URI che può essere trasportato tra dispositivi, backup/ripristino e altri contesti e può comunque fare riferimento allo stesso elemento di dati. In genere, questa operazione viene implementata aggiungendo parametri di query all'URI che consente al provider di contenuti di verificare che un URI canonico in ingresso faccia riferimento agli stessi dati originariamente previsti e, se non lo è, per trovare tali dati (se esistenti) nell'ambiente corrente.

Ad esempio, se il provider di contenuti contiene persone e un normale URI in esso viene creato con un indice di riga in tale database di persone, la rappresentazione cananica può avere un parametro di query aggiuntivo alla fine che specifica il nome della persona a cui è destinato. Le chiamate successive nel provider con tale URI cercheranno la riga dell'indice di base dell'URI e, se non corrisponde o il nome della voce non corrisponde al nome nel parametro della query, eseguire una query sul relativo database per trovare la riga corretta su cui operare.

Se si implementa il supporto per gli URI canonici, <le chiamate in ingresso b></b> con URI (incluso questo) devono eseguire questa verifica e il ripristino di qualsiasi URI canonico ricevuto. Inoltre, è necessario implementare #uncanonicalize anche per rimuovere la canonizzazione di uno di questi URI.

L'implementazione predefinita di questo metodo restituisce null, a indicare che gli URI canonici non sono supportati.

per android.content.ContentProvider.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