DateTimePrompt class

datetime 式の入力をユーザーに求めます。

Extends

注釈

既定では、プロンプトは呼び出し元のダイアログに DateTimeResolution[]に戻ります。

コンストラクター

DateTimePrompt(string, PromptValidator<DateTimeResolution[]>, string)

新しい DateTimePrompt インスタンスを作成します。

プロパティ

defaultLocale

認識する必要がある既定のロケールを確認します。

id

ダイアログの一意の ID。 ダイアログの一意の ID を設定します。

telemetryClient

このダイアログのテレメトリ クライアントを取得します。 このダイアログのテレメトリ クライアントを設定します。

継承されたプロパティ

EndOfTurn

既定のターン終了の結果を取得します。

継承されたメソッド

beginDialog(DialogContext, PromptOptions)

プロンプト ダイアログがダイアログ スタックにプッシュされ、アクティブ化されるときに呼び出されます。

configure(Record<string, unknown>)

オブジェクトを構成するための Fluent メソッド。

continueDialog(DialogContext)

プロンプト ダイアログがアクティブなダイアログであり、ユーザーが新しいアクティビティで応答したときに呼び出されます。

endDialog(TurnContext, DialogInstance, DialogReason)

派生クラスでオーバーライドされると、ダイアログが終了する前にクリーンアップを実行します。

getConverter(string)
getVersion()

再デプロイ時のボットの変更の検出に役立つエンコードされた文字列。

onDialogEvent(DialogContext, DialogEvent)

現在のダイアログまたは現在のダイアログが開始したダイアログによって、DialogContext.emitEvent()を使用してイベントが発生したときに呼び出されます。

repromptDialog(TurnContext, DialogInstance)

ユーザーに入力を再度求めるプロンプト ダイアログが要求されたときに呼び出されます。

resumeDialog(DialogContext, DialogReason, any)

以前のアクティブなダイアログが完了したときなど、ダイアログ スタック上のアクティブなダイアログとしてプロンプト ダイアログが再開されたときに呼び出されます。

コンストラクターの詳細

DateTimePrompt(string, PromptValidator<DateTimeResolution[]>, string)

新しい DateTimePrompt インスタンスを作成します。

new DateTimePrompt(dialogId: string, validator?: PromptValidator<DateTimeResolution[]>, defaultLocale?: string)

パラメーター

dialogId

string

DialogSet または ComponentDialog内のダイアログの一意の ID。

validator

PromptValidator<DateTimeResolution[]>

(省略可能) ユーザーがプロンプトに応答するたびに呼び出される検証コントロール。

defaultLocale

string

(省略可能) TurnContext.activity.locale が指定されていない場合に使用するロケール。 既定値は en-usです。

プロパティの詳細

defaultLocale

認識する必要がある既定のロケールを確認します。

defaultLocale: string | undefined

プロパティ値

string | undefined

id

ダイアログの一意の ID。 ダイアログの一意の ID を設定します。

string id

プロパティ値

string

ダイアログの ID。

注釈

これは、指定されていない場合は自動的に生成されます。

telemetryClient

このダイアログのテレメトリ クライアントを取得します。 このダイアログのテレメトリ クライアントを設定します。

BotTelemetryClient telemetryClient

プロパティ値

BotTelemetryClient

ログ記録に使用する BotTelemetryClient

継承されたプロパティの詳細

EndOfTurn

既定のターン終了の結果を取得します。

static EndOfTurn: DialogTurnResult

プロパティ値

注釈

この結果は、ダイアログ (またはダイアログ内の論理ステップ) が現在のターンの処理を完了し、まだアクティブであり、より多くの入力を待機していることを示します。

Dialog.EndOfTurn から継承された

継承済みメソッドの詳細

beginDialog(DialogContext, PromptOptions)

プロンプト ダイアログがダイアログ スタックにプッシュされ、アクティブ化されるときに呼び出されます。

function beginDialog(dc: DialogContext, options: PromptOptions): Promise<DialogTurnResult>

パラメーター

dc
DialogContext

会話の現在のターンの DialogContext

options
PromptOptions

随意。 PromptOptions、起動中のプロンプトに渡す追加情報。

戻り値

Promise<DialogTurnResult>

非同期操作を表す Promise

注釈

タスクが成功した場合、結果は、プロンプトによってターンが処理された後もプロンプトがまだアクティブかどうかを示します。

Prompt.beginDialog から継承された

configure(Record<string, unknown>)

オブジェクトを構成するための Fluent メソッド。

function configure(config: Record<string, unknown>): this

パラメーター

config

Record<string, unknown>

適用する構成設定。

戻り値

this

操作が完了した後の 構成可能な

継承構成可能。構成

continueDialog(DialogContext)

プロンプト ダイアログがアクティブなダイアログであり、ユーザーが新しいアクティビティで応答したときに呼び出されます。

function continueDialog(dc: DialogContext): Promise<DialogTurnResult>

パラメーター

dc
DialogContext

会話の現在のターンの DialogContext

戻り値

Promise<DialogTurnResult>

非同期操作を表す Promise

注釈

タスクが成功した場合、結果は、ダイアログによってターンが処理された後もダイアログがアクティブかどうかを示します。 通常、プロンプトは、ユーザーの応答をプロンプトの有効な入力として受け入れるまで、ユーザーの応答を受け取り続けます。

Prompt.continueDialog から継承された

endDialog(TurnContext, DialogInstance, DialogReason)

派生クラスでオーバーライドされると、ダイアログが終了する前にクリーンアップを実行します。

function endDialog(_context: TurnContext, _instance: DialogInstance, _reason: DialogReason): Promise<void>

パラメーター

_context

TurnContext

ターンのコンテキスト オブジェクト。

_instance
DialogInstance

このダイアログの現在の状態情報。

_reason
DialogReason

ダイアログが終了する理由。

戻り値

Promise<void>

注釈

終了する前にログ記録またはクリーンアップを実行する必要がある派生ダイアログは、このメソッドをオーバーライドする必要があります。 既定では、このメソッドは無効です。

DialogContext は、現在のダイアログが終了するときにこのメソッドを呼び出します。

も参照

Dialog.endDialog から継承された

getConverter(string)

function getConverter(_property: string): Converter | ConverterFactory

パラメーター

_property

string

条件付きセレクター構成のキー。

戻り値

セレクター構成のコンバーター。

継承元構成可能な.getConverter

getVersion()

再デプロイ時のボットの変更の検出に役立つエンコードされた文字列。

function getVersion(): string

戻り値

string

ダイアログを再起動する方法でダイアログが変更された場合にのみ変更する一意の文字列。

注釈

既定では、id ダイアログが返されますが、より正確な変更検出ロジックを提供するためにオーバーライドできます。 バージョンが変更されたスタック上のダイアログでは、versionChanged イベントが発生します。 このイベントがボットによって処理されない場合は、エラーがスローされ、ボットのエラー ハンドラー ロジックが実行されます。

空の文字列を返すと、コンポーネントのバージョン追跡がすべて無効になります。

Dialog.getVersion から継承された

onDialogEvent(DialogContext, DialogEvent)

現在のダイアログまたは現在のダイアログが開始したダイアログによって、DialogContext.emitEvent()を使用してイベントが発生したときに呼び出されます。

function onDialogEvent(dc: DialogContext, e: DialogEvent): Promise<boolean>

パラメーター

dc
DialogContext

会話の現在のターンのダイアログ コンテキスト。

e
DialogEvent

発生しているイベント。

戻り値

Promise<boolean>

True の 場合は、イベントが現在のダイアログで処理され、バブルを停止する必要があります。

Dialog.onDialogEvent から継承された

repromptDialog(TurnContext, DialogInstance)

ユーザーに入力を再度求めるプロンプト ダイアログが要求されたときに呼び出されます。

function repromptDialog(context: TurnContext, instance: DialogInstance): Promise<void>

パラメーター

context

TurnContext

(xref:botbuilder-core。TurnContext)、ユーザーとの会話の現在のターンのコンテキスト。

instance
DialogInstance

(xref:botbuilder-dialogs。DialogInstance)、スタック上のダイアログのインスタンス。

戻り値

Promise<void>

非同期操作を表す Promise

Prompt.repromptDialog から継承された

resumeDialog(DialogContext, DialogReason, any)

以前のアクティブなダイアログが完了したときなど、ダイアログ スタック上のアクティブなダイアログとしてプロンプト ダイアログが再開されたときに呼び出されます。

function resumeDialog(dc: DialogContext, _reason: DialogReason, _result?: any): Promise<DialogTurnResult>

パラメーター

dc
DialogContext

会話の現在のターンの DialogContext。

_reason
DialogReason

ダイアログが再開された理由を示す列挙型。

_result

any

省略可能。スタック上の前のダイアログから返された値。 返される値の型は、前のダイアログに依存します。

戻り値

Promise<DialogTurnResult>

非同期操作を表す Promise。

注釈

タスクが成功した場合、結果は、ダイアログによってターンが処理された後もダイアログがアクティブかどうかを示します。

Prompt.resumeDialog から継承された