HttpRequest class

套件:

botbuilder-dialogs-adaptive

執行 HttpRequest的動作。

Extends

Dialog<O>

建構函式

HttpRequest()	初始化 HttpRequest 類別的新實例。
HttpRequest(HttpMethod, string, [key: string]: string, any)	初始化 HttpRequest 類別的新實例。

屬性

$kind
body	Http 主體
contentType	要求本文的內容類型
disabled	如果 為 true 的選擇性運算式將會停用此動作。
headers	Http 標頭
method	Http 方法
responseType	回應的回應類型
resultProperty	取得或設定要儲存 HTTP 回應的屬性表達式。
url	http 網址

繼承的屬性

EndOfTurn	取得預設回合結束結果。
id
telemetryClient

方法

beginDialog(DialogContext, O)	啟動新的 對話框，並將其推送至對話堆棧。
getConverter(Object)

繼承的方法

configure(Record<string, unknown>)	用於設定物件的 Fluent 方法。
continueDialog(DialogContext)	在衍生類別中覆寫時，繼續對話。
endDialog(TurnContext, DialogInstance, DialogReason)	在衍生類別中覆寫時，會在對話結束之前執行清除。
getVersion()	編碼字串，用來協助在重新部署時偵測 Bot 變更。
onDialogEvent(DialogContext, DialogEvent)	使用 DialogContext.emitEvent()引發事件時，由目前對話框或目前對話框啟動的對話框呼叫。
repromptDialog(TurnContext, DialogInstance)	在衍生類別中覆寫時，將使用者重新命名為輸入。
resumeDialog(DialogContext, DialogReason, any)	在衍生類別中覆寫時，在堆疊上對話框完成之後繼續對話。

建構函式詳細資料

HttpRequest()

初始化 HttpRequest 類別的新實例。

new HttpRequest()

HttpRequest(HttpMethod, string, [key: string]: string, any)

初始化 HttpRequest 類別的新實例。

new HttpRequest(method: HttpMethod, url: string, headers: [key: string]: string, body: any)

參數

method

HttpMethod

HttpMethod，例如 POST、GET、DELETE 或 PUT。

url

string

要求的 URL。

headers

[key: string]: string

要求的標頭。

body

any

要求的原始本文。

屬性詳細資料

$kind

static $kind: string

屬性值

string

body

Http 主體

body?: ValueExpression

屬性值

ValueExpression

contentType

要求本文的內容類型

contentType?: StringExpression

屬性值

StringExpression

disabled

如果 為 true 的選擇性運算式將會停用此動作。

disabled?: BoolExpression

屬性值

BoolExpression

headers

Http 標頭

headers?: [key: string]: StringExpression

屬性值

[key: string]: StringExpression

method

Http 方法

method?: HttpMethod

屬性值

HttpMethod

responseType

回應的回應類型

responseType?: EnumExpression<ResponsesTypes>

屬性值

EnumExpression<ResponsesTypes>

resultProperty

取得或設定要儲存 HTTP 回應的屬性表達式。

resultProperty: StringExpression

屬性值

StringExpression

url

http 網址

url?: StringExpression

屬性值

StringExpression

繼承的屬性詳細資料

EndOfTurn

取得預設回合結束結果。

static EndOfTurn: DialogTurnResult

屬性值

DialogTurnResult

備註

此結果表示對話（或對話內的邏輯步驟）已完成目前回合的處理，仍在使用中，而且正在等候更多輸入。

繼承自 Dialog.EndOfTurn

id

id: string

屬性值

string

繼承自 Dialog.id

telemetryClient

telemetryClient: BotTelemetryClient

屬性值

BotTelemetryClient

繼承自 Dialog.telemetryClient

方法詳細資料

beginDialog(DialogContext, O)

啟動新的 對話框，並將其推送至對話堆棧。

function beginDialog(dc: DialogContext, _options?: O): Promise<DialogTurnResult>

參數

dc

DialogContext

目前交談回合的 DialogContext。

_options

O

自選。 要傳遞至對話框的初始資訊。

傳回

Promise<DialogTurnResult>

表示異步作的 Promise。

getConverter(Object)

function getConverter(property: Object): Converter | ConverterFactory

參數

property

Object

條件式選取器組態的索引鍵。

傳回

Converter | ConverterFactory

選取器組態的轉換器。

繼承的方法的詳細資料

configure(Record<string, unknown>)

用於設定物件的 Fluent 方法。

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

參數

config

Record<string, unknown>

要套用的組態設定。

傳回

this

作業完成之後 可設定。

繼承自 Configure.configure

continueDialog(DialogContext)

在衍生類別中覆寫時，繼續對話。

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

參數

dc

DialogContext

目前對話框回合的內容。

傳回

Promise<DialogTurnResult>

解決對話框回合結果的承諾。

備註

支援多回合交談的衍生對話應該覆寫此方法。 根據預設，這個方法會發出對話框已完成並傳回的訊號。

DialogContext 在繼續對話時呼叫此方法。

若要向對話框內容發出訊號，表示此對話框已完成，請在結束此方法之前，先等候 dialogContext.endDialog 。

另請參閱

• DialogContext.continueDialog

繼承自 Dialog.continueDialog

endDialog(TurnContext, DialogInstance, DialogReason)

在衍生類別中覆寫時，會在對話結束之前執行清除。

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

參數

_context

TurnContext

回合的內容物件。

_instance

DialogInstance

此對話框的目前狀態資訊。

_reason

DialogReason

對話框結束的原因。

傳回

Promise<void>

備註

需要在結束之前執行記錄或清除的衍生對話應該覆寫此方法。 根據預設，這個方法沒有任何作用。

DialogContext 目前對話框結束時呼叫這個方法。

另請參閱

• DialogContext.cancelAllDialogs
• DialogContext.endDialog
• DialogContext.replaceDialog

繼承自 Dialog.endDialog

getVersion()

編碼字串，用來協助在重新部署時偵測 Bot 變更。

function getVersion(): string

傳回

string

唯一的字串，只有在對話框以應該重新啟動對話框的方式變更時才會變更。

備註

這預設會傳回對話框 標識子，但可以覆寫以提供更精確的變更偵測邏輯。 堆疊上具有其版本變更的任何對話框都會引發 versionChanged 事件。 如果 Bot 未處理此事件，則會擲回錯誤，導致 Bot 錯誤處理程式邏輯正在執行。

傳回空字串將會一起停用元件的版本追蹤。

繼承自 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

回合的內容物件。

_instance

DialogInstance

此對話框的目前狀態資訊。

傳回

Promise<void>

備註

支持驗證和重新提示邏輯的衍生對話應該覆寫此方法。 根據預設，這個方法沒有任何作用。

DialogContext 當目前的對話框應該重新要求使用者輸入時，就會呼叫此方法。 這個方法會針對提示對話框實作。

另請參閱

• DialogContext.repromptDialog
• 提示

繼承自 Dialog.repromptDialog

resumeDialog(DialogContext, DialogReason, any)

在衍生類別中覆寫時，在堆疊上對話框完成之後繼續對話。

function resumeDialog(dc: DialogContext, reason: DialogReason, result?: any): Promise<DialogTurnResult>

參數

dc

DialogContext

目前對話框回合的內容。

reason

DialogReason

對話繼續的原因。 這通常會 DialogReason.endCalled

result

any

自選。 結束之對話框的傳回值，如果有的話。

傳回

Promise<DialogTurnResult>

解決對話框回合結果的承諾。

備註

支援多回合交談的衍生對話應該覆寫此方法。 根據預設，這個方法會發出對話框已完成並傳回的訊號。

DialogContext 在繼續對話時呼叫此方法。 如果堆疊上的上一個對話框傳回值，該值會位於 result 參數中。

若要啟動 子 對話框，請使用 DialogContext.beginDialog 或 DialogContext.prompt;不過，此對話框不一定是啟動子對話的對話框。 若要向對話框內容發出訊號，表示此對話框已完成，請在結束此方法之前，先等候 dialogContext.endDialog 。

另請參閱

• DialogContext.endDialog

繼承自 Dialog.resumeDialog