ContentProvider.Canonicalize(Uri) Método

Definición

Espacio de nombres:: Android.Content

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Implemente esto para admitir la canónicaización de URI que hacen referencia al proveedor de contenido.

[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

Parámetros

url: Uri

Identificador URI que se va a canónico.

Devoluciones

Uri

Devuelve la representación canónica de <var>url</var> o null si no se admite la canónicaización de ese URI.

Atributos: RegisterAttribute

Comentarios

Implemente esto para admitir la canónicaización de URI que hacen referencia al proveedor de contenido. Un URI canónico es uno que se puede transportar entre dispositivos, copias de seguridad y restauración y otros contextos, y que todavía puede hacer referencia al mismo elemento de datos. Normalmente, esto se implementa mediante la adición de parámetros de consulta al URI que permite al proveedor de contenido comprobar que un URI canónico entrante hace referencia a los mismos datos que estaba pensado originalmente para y, si no lo hace, para encontrar esos datos (si existe) en el entorno actual.

Por ejemplo, si el proveedor de contenido contiene personas y un URI normal en él se crea con un índice de fila en esa base de datos de personas, la representación canónica puede tener un parámetro de consulta adicional al final, que especifica el nombre de la persona a la que está destinado. Las llamadas posteriores al proveedor con ese URI buscarán la fila del índice base de ese URI y, si no coincide o su nombre de entrada no coincide con el nombre en el parámetro de consulta, realice una consulta en su base de datos para encontrar la fila correcta en la que operar.

Si implementa compatibilidad con URI canónicos, <b>todas</b> llamadas entrantes con URI (incluido este) debe realizar esta comprobación y recuperación de los URI canónicos que reciban. Además, también debe implementar #uncanonicalize para quitar la canónica de cualquiera de estos URI.

La implementación predeterminada de este método devuelve null, lo que indica que no se admiten URI canónicos.

Java documentación para android.content.ContentProvider.canonicalize(android.net.Uri).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a