ActivityHandler.OnConversationUpdateActivityAsync Methode

Referenz

Definition

Namespace:: Microsoft.Bot.Builder

Assembly:: Microsoft.Bot.Builder.dll

Paket:: Microsoft.Bot.Builder v4.18.1

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.

Wird aufgerufen, wenn eine Unterhaltungsaktualisierungsaktivität vom Kanal empfangen wird, wenn das Basisverhalten von OnTurnAsync(ITurnContext, CancellationToken) verwendet wird. Unterhaltungsaktualisierungsaktivitäten sind nützlich, wenn es darum geht, darauf zu reagieren, dass Benutzer der Unterhaltung hinzugefügt oder daraus entfernt werden. Ein Bot könnte beispielsweise auf einen hinzugefügten Benutzer reagieren, indem er den Benutzer begrüßt. Standardmäßig ruft diese Methode auf OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) , wenn Benutzer hinzugefügt wurden oder OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) wenn Benutzer entfernt wurden. Die -Methode überprüft die Member-ID, sodass sie nur auf Updates in Bezug auf andere Member als den Bot selbst reagiert.

protected virtual System.Threading.Tasks.Task OnConversationUpdateActivityAsync (Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IConversationUpdateActivity> turnContext, System.Threading.CancellationToken cancellationToken);

abstract member OnConversationUpdateActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IConversationUpdateActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnConversationUpdateActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IConversationUpdateActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Protected Overridable Function OnConversationUpdateActivityAsync (turnContext As ITurnContext(Of IConversationUpdateActivity), cancellationToken As CancellationToken) As Task

Parameter

turnContext: ITurnContext<IConversationUpdateActivity>

Ein stark typisiertes Kontextobjekt für diesen Turn.

cancellationToken: CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um Nachricht vom Abbruch zu empfangen.

Gibt zurück

Task

Eine Aufgabe, die die auszuführende Arbeit in der Warteschlange darstellt.

Hinweise

Wenn die OnTurnAsync(ITurnContext, CancellationToken) Methode eine Konversationsaktualisierungsaktivität empfängt, ruft sie diese Methode auf. Wenn die Unterhaltungsaktualisierungsaktivität angibt, dass andere Mitglieder als der Bot der Konversation beigetreten sind, wird aufgerufen OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). Wenn die Unterhaltungsaktualisierungsaktivität angibt, dass andere Mitglieder als der Bot die Unterhaltung verlassen haben, wird aufgerufen OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken).

Überschreiben Sie in einer abgeleiteten Klasse diese Methode, um Logik hinzuzufügen, die für alle Aktivitäten zum Aktualisieren von Unterhaltungen gilt. Fügen Sie Logik hinzu, die angewendet werden soll, bevor der Member Logik vor dem Aufruf der Basisklassenmethode OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) hinzugefügt oder entfernt hat. Fügen Sie Logik hinzu, die angewendet werden soll, nachdem der Member Logik nach dem Aufruf der Basisklassenmethode OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) hinzugefügt oder entfernt hat.

Gilt für:

Freigeben über