ContentResolver.Canonicalize(Uri) Método

Definição

Transforme a url< var/var> fornecida <>em uma representação canônica de seu recurso referenciado, que pode ser usada entre dispositivos, persistido, backup e restauração, 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

Parâmetros

url
Uri

O Uri que deve ser transformado em uma representação canônica. Como todas as chamadas de resolvedor, a entrada pode ser um Uri não canônico ou canônico.

Retornos

Uri

Retorna a representação canônica oficial de <var>url</var> ou nula se o provedor de conteúdo não der suporte a uma representação canônica do Uri fornecido. Muitos provedores podem não dar suporte à canonização de alguns ou de todos os uris.

Atributos

Comentários

Transforme a url< var/var> fornecida <>em uma representação canônica de seu recurso referenciado, que pode ser usada entre dispositivos, persistido, backup e restauração, etc. O Uri retornado ainda é um Uri totalmente capaz de ser usado com seu provedor de conteúdo, permitindo que você faça todas as mesmas operações de provedor de conteúdo como com o Uri original -- #query, #openInputStream(android.net.Uri)etc. A única diferença de comportamento entre o Uris original e o novo é que o provedor de conteúdo pode precisar fazer algum trabalho adicional em cada chamada usando-o para resolvê-lo para o recurso correto, especialmente se o Uri canônico tiver sido movido para um ambiente diferente.

Se você estiver movendo um Uri canônico entre ambientes, deverá executar outra chamada com #canonicalize esse Uri original para re canonizá-lo para o ambiente atual. Como alternativa, talvez você queira usá-lo #uncanonicalize para transformá-lo em um Uri não canônico que funcione apenas no ambiente atual, mas potencialmente com mais eficiência do que a representação canônica.

Java documentação para android.content.ContentResolver.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

Confira também