Aktualisieren und Löschen von Nachrichten, die von Ihrem bot gesendet wurdenUpdate and delete messages sent from your bot

Wichtig

Die Codebeispiele in diesem Abschnitt basieren auf 4,6 und höheren Versionen des bot Framework SDK.The code samples in this section are based on 4.6 and later versions of the Bot Framework SDK. Wenn Sie nach einer Dokumentation für frühere Versionen suchen, lesen Sie den Abschnitt Bots-V3 SDK im Ordner Resources der Dokumentation.If you're looking for documentation for earlier versions, see the Bots - v3 SDK section in the Resources folder of the documentation.

Aktualisieren von NachrichtenUpdating messages

Anstatt Ihre Nachrichten als statische Momentaufnahmen von Daten zu haben, kann Ihr bot Nachrichten nach dem Senden dynamisch aktualisieren.Rather than have your messages be static snapshots of data, your bot can dynamically update messages after sending them. Sie können dynamische Nachrichten Aktualisierungen für Szenarien wie Abruf Aktualisierungen, das Ändern von verfügbaren Aktionen nach einer Tastendruck oder andere asynchrone Statusänderungen verwenden.You can use dynamic message updates for scenarios such as poll updates, modifying available actions after a button press, or any other asynchronous state change.

Die neue Nachricht muss nicht mit dem Original in Type übereinstimmen.The new message need not match the original in type. Wenn die ursprüngliche Nachricht beispielsweise eine Anlage enthielt, kann es sich bei der neuen Nachricht um eine einfache Textnachricht handeln.For instance, if the original message contained an attachment, the new message can be a simple text message.

Um eine vorhandene Nachricht zu aktualisieren, übergeben Sie Activity ein neues Objekt mit der vorhandenen Aktivitäts- UpdateActivityAsync ID an die TurnContext Methode der Klasse.To update an existing message, pass a new Activity object with the existing activity ID to the UpdateActivityAsync method of the TurnContext class. Siehe TurnContextClassSee TurnContextClass

var newActivity = MessageFactory.Text("The new text for the activity");
newActivity.Id = activityId;
await turnContext.UpdateActivityAsync(newActivity, cancellationToken);

Löschen von NachrichtenDeleting messages

Im bot-Framework hat jede Nachricht eine eigene eindeutige Aktivitäts-ID.In the Bot Framework, every message has its own unique activity identifier. Nachrichten können mithilfe der DeleteActivity Methode des bot-Frameworks wie hier gezeigt gelöscht werden.Messages can be deleted using the Bot Framework's DeleteActivity method as shown here.

Um diese Nachricht zu löschen, übergeben Sie die ID der Aktivität DeleteActivityAsync an die Methode TurnContext der Klasse.To delete that message, pass that activity's ID to the DeleteActivityAsync method of the TurnContext class. Siehe turncontext. DeleteActivityAsync-MethodeSee TurnContext.DeleteActivityAsync Method

foreach (var activityId in _list)
{
    await turnContext.DeleteActivityAsync(activityId, cancellationToken);
}