WaterfallDialog 類別

定義

命名空間:: Microsoft.Bot.Builder.Dialogs

組件:: Microsoft.Bot.Builder.Dialogs.dll

套件:: Microsoft.Bot.Builder.Dialogs v4.22.7

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

已針對提示使用者提供一系列問題而優化的對話框。瀑布式會接受會依序執行的函式堆疊。每個瀑布步驟都可以詢問用戶的問題，而用戶的回應將會作為自變數傳遞至下一個瀑布步驟。

public class WaterfallDialog : Microsoft.Bot.Builder.Dialogs.Dialog

type WaterfallDialog = class
    inherit Dialog

Public Class WaterfallDialog
Inherits Dialog

繼承: Object

Dialog
WaterfallDialog

衍生: Microsoft.Bot.Builder.AI.QnA.Dialogs.QnAMakerDialog

建構函式

名稱	Description
WaterfallDialog(String, IEnumerable<WaterfallStep>)	初始化 WaterfallDialog 類別的新執行個體。

屬性

名稱	Description
Id	取得或設定對話的 ID。 (繼承來源 Dialog)
Source	取得 cref=“SourceRange”/> 的資訊。 (繼承來源 Dialog)
TelemetryClient	取得或設定 IBotTelemetryClient 用於記錄。 (繼承來源 Dialog)

方法

名稱	Description
AddStep(WaterfallStep)	將新的步驟新增至瀑布。
BeginDialogAsync(DialogContext, Object, CancellationToken)	當瀑布式對話啟動並推送至對話堆疊時呼叫。
ContinueDialogAsync(DialogContext, CancellationToken)	當瀑布對話框繼續時呼叫，當它為活躍對話，使用者回覆新的活動時。
EndDialogAsync(ITurnContext, DialogInstance, DialogReason, CancellationToken)	對話框結束時呼叫。
GetVersion()	會得到一個唯一字串，代表該對話框的版本。如果之間的版本變更，對話系統將會發出 DialogChanged 事件。
OnComputeId()	建立對話的計算 ID。 (繼承來源 Dialog)
OnDialogEventAsync(DialogContext, DialogEvent, CancellationToken)	使用 `DialogContext.emitEvent()`引發事件時，由目前對話框或目前對話框啟動的對話框呼叫。 (繼承來源 Dialog)
OnPostBubbleEventAsync(DialogContext, DialogEvent, CancellationToken)	在事件向所有家長泡泡後呼叫，但未處理。 (繼承來源 Dialog)
OnPreBubbleEventAsync(DialogContext, DialogEvent, CancellationToken)	在事件反升至其父系之前呼叫。 (繼承來源 Dialog)
OnStepAsync(WaterfallStepContext, CancellationToken)	執行個別瀑布式步驟時呼叫。
RegisterSourceLocation(String, Int32)	在指定位置註冊 cref=“SourceRange”/> 。 (繼承來源 Dialog)
RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken)	當對話框應該重新提示使用者輸入時呼叫。 (繼承來源 Dialog)
ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken)	當子瀑布式對話完成回合時呼叫，將控件傳回這個對話框。
RunStepAsync(DialogContext, Int32, DialogReason, Object, CancellationToken)	執行瀑布式對話的步驟。

擴充方法

名稱	Description
RunAsync(Dialog, ITurnContext, IStatePropertyAccessor<DialogState>, CancellationToken)	建立對話堆疊並啟動對話，並將它推送至堆疊。

適用於