AppNotificationBuilder.AddText Methode

Definition

Namespace:

Microsoft.Windows.AppNotifications.Builder

Überlädt

AddText(String)	Fügt der XML-Nutzlast für eine App-Benachrichtigung einen Textblock hinzu.
AddText(String, AppNotificationTextProperties)	Fügt der XML-Nutzlast für eine App-Benachrichtigung einen Textblock mit Anzeige- und Lokalisierungsoptionen hinzu.

AddText(String)

Fügt der XML-Nutzlast für eine App-Benachrichtigung einen Textblock hinzu.

public:
 virtual AppNotificationBuilder ^ AddText(Platform::String ^ text) = AddText;

/// [Windows.Foundation.Metadata.Overload("AddText")]
AppNotificationBuilder AddText(winrt::hstring const& text);

[Windows.Foundation.Metadata.Overload("AddText")]
public AppNotificationBuilder AddText(string text);

function addText(text)

Public Function AddText (text As String) As AppNotificationBuilder

Parameter

text

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die den Text enthält, der in der App-Benachrichtigung angezeigt werden soll.

Gibt zurück

AppNotificationBuilder

Gibt die AppNotificationBuilder- Instanz zurück, sodass zusätzliche Methodenaufrufe verkettet werden können.

Attribute

OverloadAttribute

Beispiele

Das folgende Beispiel veranschaulicht das Hinzufügen eines Textblocks zur XML-Nutzlast für eine App-Benachrichtigung.

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

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
</toast>

Hinweise

Einer App-Benachrichtigung können maximal drei Textelemente hinzugefügt werden. Wenn Sie diesen Grenzwert überschreiten, wird ein Fehler ausgelöst.

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.

AddText(String, AppNotificationTextProperties)

Fügt der XML-Nutzlast für eine App-Benachrichtigung einen Textblock mit Anzeige- und Lokalisierungsoptionen hinzu.

public:
 virtual AppNotificationBuilder ^ AddText(Platform::String ^ text, AppNotificationTextProperties ^ properties) = AddText;

/// [Windows.Foundation.Metadata.Overload("AddText2")]
AppNotificationBuilder AddText(winrt::hstring const& text, AppNotificationTextProperties const& properties);

[Windows.Foundation.Metadata.Overload("AddText2")]
public AppNotificationBuilder AddText(string text, AppNotificationTextProperties properties);

function addText(text, properties)

Public Function AddText (text As String, properties As AppNotificationTextProperties) As AppNotificationBuilder

Parameter

text

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die den Text enthält, der in der App-Benachrichtigung angezeigt werden soll.

properties

AppNotificationTextProperties

Eine AppNotificationTextProperties Angeben von Anzeige- und Lokalisierungseigenschaften für den Text.

Gibt zurück

AppNotificationBuilder

Gibt die AppNotificationBuilder- Instanz zurück, sodass zusätzliche Methodenaufrufe verkettet werden können.

Attribute

OverloadAttribute

Beispiele

Das folgende Beispiel veranschaulicht das Hinzufügen eines Textblocks zur XML-Nutzlast für eine App-Benachrichtigung.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.", new AppNotificationTextProperties().SetMaxLines(2))
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text hint-maxLines='2'>Notification text.</text>
        </binding>
    </visual>
</toast>

Hinweise

Einer App-Benachrichtigung können maximal drei Textelemente hinzugefügt werden. Wenn Sie diesen Grenzwert überschreiten, wird ein Fehler ausgelöst.

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.