TurnContext.SendActivityAsync 方法

定义

命名空间:

Microsoft.Bot.Builder

程序集:

Microsoft.Bot.Builder.dll

包:

Microsoft.Bot.Builder v4.18.1

重载

SendActivityAsync(IActivity, CancellationToken)	将活动发送给传入活动的发送方。
SendActivityAsync(String, String, String, CancellationToken)	向传入活动的发送方发送消息活动。

SendActivityAsync(IActivity, CancellationToken)

将活动发送给传入活动的发送方。

public System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse> SendActivityAsync (Microsoft.Bot.Schema.IActivity activity, System.Threading.CancellationToken cancellationToken = default);

abstract member SendActivityAsync : Microsoft.Bot.Schema.IActivity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse>
override this.SendActivityAsync : Microsoft.Bot.Schema.IActivity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse>

Public Function SendActivityAsync (activity As IActivity, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ResourceResponse)

参数

activity

IActivity

要发送的活动。

cancellationToken

CancellationToken

取消标记。

返回

Task<ResourceResponse>

表示排队等待执行的工作的任务。

实现

SendActivityAsync(IActivity, CancellationToken)

例外

ArgumentNullException

activity 为 null。

注解

如果活动成功发送，则任务结果将包含一个 ResourceResponse 对象，该对象包含接收通道分配给活动的 ID。

SendActivityAsync(String, String, String, CancellationToken)

向传入活动的发送方发送消息活动。

public System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse> SendActivityAsync (string textReplyToSend, string speak = default, string inputHint = default, System.Threading.CancellationToken cancellationToken = default);

abstract member SendActivityAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse>
override this.SendActivityAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse>

Public Function SendActivityAsync (textReplyToSend As String, Optional speak As String = Nothing, Optional inputHint As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ResourceResponse)

参数

textReplyToSend

String

要发送的消息的文本。

speak

String

（可选）机器人在支持语音的通道上朗读的文本。

inputHint

String

可选，指示机器人在将消息传递到客户端后是接受、期望还是忽略用户输入。 其中之一：“acceptingInput”、“ignoringInput”或“expectingInput”。 默认值为 null。

cancellationToken

CancellationToken

取消标记。

返回

Task<ResourceResponse>

表示排队等待执行的工作的任务。

实现

SendActivityAsync(String, String, String, CancellationToken)

例外

ArgumentNullException

textReplyToSend 为 null 或空格。

注解

如果活动成功发送，则任务结果将包含一个 ResourceResponse 对象，该对象包含接收通道分配给活动的 ID。

有关对 的内容 textReplyToSend施加的限制，请参阅通道的文档。

若要控制机器人语音的各种特征（如语音、速率、音量、发音和音调），请在语音合成标记语言 (SSML) 格式中指定 speak 。