TurnContext 类

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

提供机器人轮次的上下文。

public class TurnContext : IDisposable, Microsoft.Bot.Builder.ITurnContext

type TurnContext = class
    interface ITurnContext
    interface IDisposable

Public Class TurnContext
Implements IDisposable, ITurnContext

上下文提供处理传入活动所需的信息。上下文对象由 BotAdapter 创建，并保留轮次长度。

名称	说明
TurnContext(BotAdapter, Activity)	初始化 TurnContext 类的新实例。
TurnContext(ITurnContext, Activity)	初始化来自另一个turncontext类的新实例 TurnContext ，以针对另一个活动。

名称	说明
Activity	获取与此轮次关联的活动;或处理主动消息时 `null`。
Adapter	获取创建此上下文对象的机器人适配器。
BufferedReplyActivities	获取在“context”时要发送的活动的列表。Activity.DeliveryMode == 'expectReplies'。
Locale	获取或设置该上下文对象的地点。
Responded	获取一个值，该值指示是否为当前轮次发送了至少一个响应。
TurnState	获取在此上下文对象上注册的服务。

名称	说明
DeleteActivityAsync(ConversationReference, CancellationToken)	删除现有活动。
DeleteActivityAsync(String, CancellationToken)	删除现有活动。
Dispose()	释放资源。
Dispose(Boolean)	执行与释放、释放或重置非托管资源关联的应用程序定义任务。
OnDeleteActivity(DeleteActivityHandler)	添加用于删除活动作的响应处理程序。
OnSendActivities(SendActivitiesHandler)	添加用于发送活动作的响应处理程序。
OnUpdateActivity(UpdateActivityHandler)	为更新活动作添加响应处理程序。
SendActivitiesAsync(IActivity[], CancellationToken)	将一组活动发送到传入活动的发送方。
SendActivityAsync(IActivity, CancellationToken)	将活动发送到传入活动的发送方。
SendActivityAsync(String, String, String, CancellationToken)	向传入活动的发送方发送消息活动。
UpdateActivityAsync(IActivity, CancellationToken)	替换现有活动。

名称	说明
GetDebugger(ITurnContext)	从 TurnContext 获取 IDialogDebugger 的扩展方法。
TraceActivityAsync(ITurnContext, String, Object, String, String, CancellationToken)	将跟踪活动发送到 BotAdapter 以进行日志记录。