Prompt<T> 類別

定義

命名空間:

Microsoft.Bot.Builder.Dialogs

組件:

Microsoft.Bot.Builder.Dialogs.dll

套件:

Microsoft.Bot.Builder.Dialogs v4.22.7

定義提示對話框的核心行為。

public abstract class Prompt<T> : Microsoft.Bot.Builder.Dialogs.Dialog

type Prompt<'T> = class
    inherit Dialog

Public MustInherit Class Prompt(Of T)
Inherits Dialog

類型參數

T

提示傳回的值型別。

繼承

Object

Dialog

Prompt<T>

衍生

Microsoft.Bot.Builder.Dialogs.AttachmentPrompt

Microsoft.Bot.Builder.Dialogs.ChoicePrompt

Microsoft.Bot.Builder.Dialogs.ConfirmPrompt

Microsoft.Bot.Builder.Dialogs.DateTimePrompt

Microsoft.Bot.Builder.Dialogs.NumberPrompt<T>

Microsoft.Bot.Builder.Dialogs.TextPrompt

備註

當提示結束時，它應該會傳回 T 物件，代表提示的值。 使用 Add(Dialog) 或 AddDialog(Dialog)，分別將提示新增至對話框集或元件對話方塊。 使用 PromptAsync(String, PromptOptions, CancellationToken) 或 BeginDialogAsync(String, Object, CancellationToken) 啟動提示。 如果您從 WaterfallDialog中的 WaterfallStep 啟動提示，則瀑布的下一個步驟中將會提供提示結果。

建構函式

Prompt<T>(String, PromptValidator<T>)

初始化 Prompt<T> 類別的新實例。 從衍生類別中的建構函式呼叫，以初始化 Prompt<T> 類別。

屬性

Id	取得或設定對話框的識別碼。 (繼承來源 Dialog)
Source	取得 cref=“SourceRange”/>的資訊。 (繼承來源 Dialog)
TelemetryClient	取得或設定要用於記錄的 IBotTelemetryClient。 (繼承來源 Dialog)

方法

AppendChoices(IMessageActivity, String, IList<Choice>, ListStyle, ChoiceFactoryOptions, CancellationToken)	在衍生類別中覆寫時，在系統提示使用者輸入時，將選擇附加至活動。
AppendChoices(IMessageActivity, String, IList<Choice>, ListStyle, ChoiceFactoryOptions, String, IList<String>, CancellationToken)	在衍生類別中覆寫時，在系統提示使用者輸入時，將選擇附加至活動。
BeginDialogAsync(DialogContext, Object, CancellationToken)	當提示對話框推送至對話堆疊並正在啟動時呼叫。
ContinueDialogAsync(DialogContext, CancellationToken)	當提示對話框是作用中的對話框，且使用者以新的活動回復時呼叫。
EndDialogAsync(ITurnContext, DialogInstance, DialogReason, CancellationToken)	對話框結束時呼叫。 (繼承來源 Dialog)
GetVersion()	取得代表這個對話框版本的唯一字串。 如果之間的版本變更，對話系統將會發出 DialogChanged 事件。 (繼承來源 Dialog)
OnComputeId()	建置對話框的計算標識碼。 (繼承來源 Dialog)
OnDialogEventAsync(DialogContext, DialogEvent, CancellationToken)	使用 DialogContext.emitEvent()引發事件時，由目前對話框或目前對話框啟動的對話框呼叫。 (繼承來源 Dialog)
OnPostBubbleEventAsync(DialogContext, DialogEvent, CancellationToken)	在事件向所有家長泡泡後呼叫，但未處理。 (繼承來源 Dialog)
OnPreBubbleEventAsync(DialogContext, DialogEvent, CancellationToken)	在事件反升至其父系之前呼叫。
OnPromptAsync(ITurnContext, IDictionary<String,Object>, PromptOptions, Boolean, CancellationToken)	在衍生類別中覆寫時，提示用戶輸入。
OnRecognizeAsync(ITurnContext, IDictionary<String,Object>, PromptOptions, CancellationToken)	在衍生類別中覆寫時，會嘗試辨識用戶的輸入。
RegisterSourceLocation(String, Int32)	在提供的位置註冊 cref=“SourceRange”/>。 (繼承來源 Dialog)
RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken)	當要求提示對話方塊重新提示使用者輸入時呼叫。
ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken)	當提示對話框繼續成為對話堆疊上的使用中對話框時呼叫，例如當堆棧上的上一個使用中對話方塊完成時。

擴充方法

RunAsync(Dialog, ITurnContext, IStatePropertyAccessor<DialogState>, CancellationToken)

建立對話堆疊並啟動對話，並將它推送至堆疊。