TurnContext 类

定义

命名空间:

Microsoft.Bot.Builder

程序集:

Microsoft.Bot.Builder.dll

包:

Microsoft.Bot.Builder v4.18.1

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

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

type TurnContext = class
    interface ITurnContext
    interface IDisposable

Public Class TurnContext
Implements IDisposable, ITurnContext

继承

Object

TurnContext

实现

ITurnContext IDisposable

注解

上下文提供处理传入活动所需的信息。 上下文对象由 创建， 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 将跟踪活动发送到 。

另请参阅

• IMiddleware
• IBot