ContentProvider.Canonicalize(Uri) Método

Definição

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Implemente isso para dar suporte à canonicalização de URIs que se referem ao seu provedor de conteúdo.

[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

O Uri a ser canonizado.

Retornos

Uri

Retorne a representação canônica de <var>url</var> ou nula se não houver suporte para a canonização desse Uri.

Atributos: RegisterAttribute

Comentários

Implemente isso para dar suporte à canonicalização de URIs que se referem ao seu provedor de conteúdo. Um URI canônico é aquele que pode ser transportado entre dispositivos, backup/restauração e outros contextos e ainda ser capaz de se referir ao mesmo item de dados. Normalmente, isso é implementado adicionando parâmetros de consulta ao URI, permitindo que o provedor de conteúdo verifique se um URI canônico de entrada faz referência aos mesmos dados que foi originalmente destinado e, se não o fizer, para localizar esses dados (se existirem) no ambiente atual.

Por exemplo, se o provedor de conteúdo contém pessoas e um URI normal é criado com um índice de linha nesse banco de dados de pessoas, a representação canânica pode ter um parâmetro de consulta adicional no final, que especifica o nome da pessoa para a qual se destina. Chamadas posteriores para o provedor com esse URI procurarão a linha do índice base desse URI e, se ele não corresponder ou o nome de sua entrada não corresponder ao nome no param de consulta, execute uma consulta em seu banco de dados para localizar a linha correta na qual operar.

Se você implementar o suporte para URIs canônicas, <as chamadas de entrada b>all</b> com URIs (incluindo esta) deverão executar essa verificação e recuperação de quaisquer URIs canônicas recebidas. Além disso, você também deve implementar #uncanonicalize para remover a canonização de qualquer uma dessas URIs.

A implementação padrão desse método retorna nulo, indicando que não há suporte para URIs canônicas.

Java documentação para android.content.ContentProvider.canonicalize(android.net.Uri).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a