ActivityHandler.OnConversationUpdateActivityAsync Methode

Definition

Namespace:: Microsoft.Bot.Builder

Assembly:: Microsoft.Bot.Builder.dll

Paket:: Microsoft.Bot.Builder v4.22.7

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, auf Benutzer zu reagieren, die der Unterhaltung hinzugefügt oder daraus entfernt werden. Beispielsweise könnte ein Bot auf einen Benutzer reagieren, der von der Begrüßung des Benutzers hinzugefügt wird. Standardmäßig ruft diese Methode OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) auf, wenn Benutzer hinzugefügt oder OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) wurden, wenn Benutzer entfernt wurden. Die Methode überprüft die Member-ID, sodass sie nur auf Aktualisierungen 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 diese Runde.

cancellationToken: CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.

Gibt zurück

Task

Eine Aufgabe, die die auszuführende Arbeitswarteschlange darstellt.

Hinweise

Wenn die OnTurnAsync(ITurnContext, CancellationToken)-Methode eine Unterhaltungsaktualisierungsaktivität empfängt, ruft sie diese Methode auf. Wenn die Aktivität der Gesprächsaktualisierung anzeigt, dass andere Mitglieder als der Bot an der Unterhaltung teilgenommen haben, ruft OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)sie . Wenn die Aktivität des Gesprächs-Updates anzeigt, dass andere Mitglieder als der Bot das Gespräch verlassen haben, ruft OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)sie auf.

Überschreiben Sie in einer abgeleiteten Klasse diese Methode, um Logik hinzuzufügen, die für alle Unterhaltungsaktualisierungsaktivitäten gilt. Fügen Sie Logik hinzu, die vor dem hinzugefügten oder entfernten Mitglied vor dem Aufruf der Basisklassenmethode OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) angewendet wird. Fügen Sie Logik hinzu, die nach dem hinzugefügten oder entfernenden Element nach dem Aufruf der Basisklassenmethode OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) angewendet wird.

Gilt für: