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 将跟踪活动发送到。