DialogContext.EndDialogAsync(Object, CancellationToken) Metode

Definisi

Mengakhiri dialog dengan memunculkannya dari tumpukan dan mengembalikan hasil opsional ke induk dialog. Dialog induk adalah dialog yang memulai saat diakh memusnahkan melalui panggilan ke BeginDialogAsync(String, Object, CancellationToken) atau PromptAsync(String, PromptOptions, CancellationToken). Dialog induk akan meminta metodenya ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) dengan hasil yang dikembalikan. Jika dialog induk belum menerapkan ResumeDialogAsync metode, maka itu akan secara otomatis berakhir juga dan hasilnya diteruskan ke induknya. Jika tidak ada lagi dialog induk pada tumpukan maka pemrosesan giliran akan berakhir.

public System.Threading.Tasks.Task<Microsoft.Bot.Builder.Dialogs.DialogTurnResult> EndDialogAsync(object result = default, System.Threading.CancellationToken cancellationToken = default);
member this.EndDialogAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Builder.Dialogs.DialogTurnResult>
Public Function EndDialogAsync (Optional result As Object = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DialogTurnResult)

Parameter

result
Object

Opsional, menghasilkan untuk diteruskan ke konteks induk.

cancellationToken
CancellationToken

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

Mengembalikan

Tugas yang mewakili pekerjaan yang diantrekan untuk dijalankan.

Keterangan

Jika tugas berhasil, hasilnya menunjukkan bahwa dialog berakhir setelah giliran diproses oleh dialog.

Secara umum, konteks induk adalah dialog atau penangan giliran bot yang memulai dialog. Jika induk adalah dialog, tumpukan memanggil metode induk ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) untuk mengembalikan hasil ke dialog induk. Jika dialog induk tidak menerapkan 'ResumeDialogAsync', maka induk juga akan berakhir, dan hasilnya diteruskan ke konteks induk berikutnya.

yang dikembalikan DialogTurnResult berisi nilai yang dikembalikan dalam propertinya Result .

Berlaku untuk

Lihat juga