ActivityHandler.OnConversationUpdateActivityAsync Metode

Referensi

Definisi

Ruang nama:: Microsoft.Bot.Builder

Rakitan:: Microsoft.Bot.Builder.dll

Paket:: Microsoft.Bot.Builder v4.22.7

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Dipanggil saat aktivitas pembaruan percakapan diterima dari saluran saat perilaku OnTurnAsync(ITurnContext, CancellationToken) dasar digunakan. Aktivitas pembaruan percakapan berguna dalam menanggapi pengguna yang ditambahkan atau dihapus dari percakapan. Misalnya, bot dapat menanggapi pengguna yang ditambahkan dengan menyapa pengguna. Secara default, metode ini akan memanggil OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) jika ada pengguna yang telah ditambahkan atau OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) jika ada pengguna yang telah dihapus. Metode ini memeriksa ID anggota sehingga hanya merespons pembaruan mengenai anggota selain bot itu sendiri.

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>

Objek konteks yang ditik dengan kuat untuk giliran ini.

cancellationToken: CancellationToken

Token pembatalan yang dapat digunakan oleh objek atau utas lain untuk menerima pemberitahuan pembatalan.

Mengembalikan

Task

Tugas yang mewakili pekerjaan yang diantrekan untuk dijalankan.

Keterangan

OnTurnAsync(ITurnContext, CancellationToken) Ketika metode menerima aktivitas pembaruan percakapan, metode ini memanggil metode ini. Jika aktivitas pembaruan percakapan menunjukkan bahwa anggota selain bot bergabung dalam percakapan, aktivitas akan memanggil OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). Jika aktivitas pembaruan percakapan menunjukkan bahwa anggota selain bot meninggalkan percakapan, aktivitas akan memanggil OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken).

Di kelas turunan, ambil alih metode ini untuk menambahkan logika yang berlaku untuk semua aktivitas pembaruan percakapan. Tambahkan logika untuk diterapkan sebelum anggota menambahkan atau menghapus logika sebelum panggilan ke metode kelas OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) dasar. Tambahkan logika untuk diterapkan setelah anggota menambahkan atau menghapus logika setelah panggilan ke metode kelas OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) dasar.

Berlaku untuk