Freigeben über


DocumentsProvider.CreateWebLinkIntent(String, Bundle) Methode

Definition

Erstellt einen Absichtsabsender für einen Weblink, wenn das Dokument weblinkbar ist.

[Android.Runtime.Register("createWebLinkIntent", "(Ljava/lang/String;Landroid/os/Bundle;)Landroid/content/IntentSender;", "GetCreateWebLinkIntent_Ljava_lang_String_Landroid_os_Bundle_Handler", ApiSince=26)]
public virtual Android.Content.IntentSender? CreateWebLinkIntent(string? documentId, Android.OS.Bundle? options);
[<Android.Runtime.Register("createWebLinkIntent", "(Ljava/lang/String;Landroid/os/Bundle;)Landroid/content/IntentSender;", "GetCreateWebLinkIntent_Ljava_lang_String_Landroid_os_Bundle_Handler", ApiSince=26)>]
abstract member CreateWebLinkIntent : string * Android.OS.Bundle -> Android.Content.IntentSender
override this.CreateWebLinkIntent : string * Android.OS.Bundle -> Android.Content.IntentSender

Parameter

documentId
String

das Dokument, für das eine Weblinkabsicht erstellt werden soll.

options
Bundle

zusätzliche Informationen, z. B. die Liste der Empfänger. Optional.

Gibt zurück

Attribute

Hinweise

Erstellt einen Absichtsabsender für einen Weblink, wenn das Dokument weblinkbar ist.

AuthenticationRequiredException kann ausgelöst werden, wenn der Benutzer nicht über ausreichende Berechtigungen für das verknüpfte Dokument verfügt. Bevor dem verknüpften Dokument neue Berechtigungen erteilt werden, muss eine sichtbare Benutzeroberfläche angezeigt werden, damit der Benutzer explizit bestätigen kann, ob die Berechtigungserteilungen erwartet werden. Der Benutzer muss in der Lage sein, den Vorgang abzubrechen.

Optionen, die als Argument übergeben werden, können eine Liste von Empfängern enthalten, z. B. E-Mail-Adressen. Der Anbieter sollte diese Optionen nach Möglichkeit wiedergeben, aber es ist akzeptabel, sie zu ignorieren. In beiden Fällen muss die Bestätigungs-UI angezeigt werden, bevor neue Berechtigungserteilungen erteilt werden.

Es ist alles recht, einen Weblink zu generieren, ohne neue Berechtigungen zu erteilen, wenn das Öffnen des Links zu einer Seite zum Anfordern des Berechtigungszugriffs führen würde. Wenn es unmöglich ist, muss der Vorgang fehlschlagen, indem eine Ausnahme ausgelöst wird.

Java-Dokumentation für android.provider.DocumentsProvider.createWebLinkIntent(java.lang.String, android.os.Bundle).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: