ContentResolver.Canonicalize(Uri) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Transformieren Sie die angegebene <Var-URL</var>> in eine kanonische Darstellung ihrer referenzierten Ressource, die geräteübergreifend verwendet, beibehalten, gesichert und wiederhergestellt werden kann usw.
[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.UriParameter
- url
- Uri
Das Uri soll in eine kanonische Darstellung umgewandelt werden. Wie bei allen Resolveraufrufen kann die Eingabe entweder ein nicht kanonischer oder kanonischer URI sein.
Gibt zurück
Gibt die offizielle kanonische Darstellung von <var>url</var> oder null zurück, wenn der Inhaltsanbieter keine kanonische Darstellung des angegebenen URI unterstützt. Viele Anbieter unterstützen möglicherweise keine Kanonisierung einiger oder aller URIs.
- Attribute
Hinweise
Transformieren Sie die angegebene <Var-URL</var>> in eine kanonische Darstellung ihrer referenzierten Ressource, die geräteübergreifend verwendet, beibehalten, gesichert und wiederhergestellt werden kann usw. Der zurückgegebene URI ist weiterhin ein voll funktionsfähiger URI für die Verwendung mit seinem Inhaltsanbieter, sodass Sie alle gleichen Inhaltsanbietervorgänge ausführen können wie mit dem ursprünglichen URI - #query, , #openInputStream(android.net.Uri)usw. Der einzige Unterschied im Verhalten zwischen dem ursprünglichen und neuen URIs besteht darin, dass der Inhaltsanbieter möglicherweise zusätzliche Arbeit bei jedem Aufruf ausführen muss, der ihn verwendet, um ihn in die richtige Ressource aufzulösen, insbesondere, wenn der kanonische URI in eine andere Umgebung verschoben wurde.
Wenn Sie einen kanonischen URI zwischen Umgebungen verschieben, sollten Sie einen weiteren Aufruf #canonicalize mit diesem ursprünglichen URI ausführen, um ihn für die aktuelle Umgebung neu zu kanonisieren. Alternativ können Sie ihn in einen nicht kanonischen URI transformieren #uncanonicalize , der nur in der aktuellen Umgebung funktioniert, aber potenziell effizienter als die kanonische Darstellung.
Java Dokumentation für android.content.ContentResolver.canonicalize(android.net.Uri).
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.