AppNotificationButton.InvokeUri Eigenschaft

Definition

Namespace:

Microsoft.Windows.AppNotifications.Builder

Ruft den URI ab, der gestartet wird, wenn auf die App-Benachrichtigungsschaltfläche geklickt wird, oder legt diesen fest.

public:
 property Uri ^ InvokeUri { Uri ^ get(); void set(Uri ^ value); };

Uri InvokeUri();

void InvokeUri(Uri value);

public System.Uri InvokeUri { get; set; }

var uri = appNotificationButton.invokeUri;
appNotificationButton.invokeUri = uri;

Public Property InvokeUri As Uri

Eigenschaftswert

Uri Uri

Ein URI--Objekt, das den aufzurufenden URI angibt.

Beispiele

Das folgende Beispiel zeigt die Verwendung dieser Eigenschaft zum Festlegen des Aufruf-URI für eine App-Benachrichtigungsschaltfläche.

var button = new AppNotificationButton("Launch URI")
    .AddArgument("action", "info");
button.InvokeUri = new Uri("https://learn.microsoft.com");

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .AddButton(button)
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <actions>
        <action content='' arguments='https://learn.microsoft.com/' activationType='protocol'/>
    </actions>
</toast>

Hinweise

Sie können den URI verwenden, um eine Website im Standardbrowser zu starten oder eine App mit einem registrierten URI-Schema zu starten. Weitere Informationen zum Starten von Apps mit URIs finden Sie unter Starten einer App mit einem URI-.

Sie sollten entweder den Aufruf-URI oder die TargetAppId-festlegen, aber nicht beide. Wenn Sie beides festlegen, verwendet das System die TargetAppId-.

Sie können den Aufruf-URI für eine App-Benachrichtigungsschaltfläche auch festlegen, indem Sie AppNotificationButton.SetInvokeUriaufrufen.

Anleitungen zur Verwendung der AppNotificationBuilder--APIs zum Erstellen der Benutzeroberfläche für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhalt.

Referenzinformationen zum XML-Schema für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhaltsschema.