Langue

BotState Classe

Définition

Définit un objet de gestion d’état et automatise la lecture et l’écriture des propriétés d’état associées dans une couche de stockage.

public abstract class BotState : Microsoft.Bot.Builder.IPropertyManager
type BotState = class
    interface IPropertyManager
Public MustInherit Class BotState
Implements IPropertyManager
Héritage
BotState
Dérivé
Implémente

Remarques

Chaque objet de gestion d’état définit une étendue pour une couche de stockage.

Les propriétés d’état sont créées dans une étendue de gestion d’état, et Bot Framework définit ces étendues : ConversationState, UserStateet PrivateConversationState.

Vous pouvez définir des étendues supplémentaires pour votre bot.

Constructeurs

Nom Description
BotState(IStorage, String)

Initialise une nouvelle instance de la classe BotState.

Méthodes

Nom Description
ClearStateAsync(ITurnContext, CancellationToken)

Ça efface la cache d’état pour ce BotStateproblème.

CreateProperty<T>(String)

Crée une propriété d’état nommée dans le champ d’application de un BotState et renvoie un accessoire pour la propriété.

DeleteAsync(ITurnContext, CancellationToken)

Supprime tout état en stockage et le cache pour cela BotState.

DeletePropertyValueAsync(ITurnContext, String, CancellationToken)

Supprime une propriété du cache d’état pour ce BotStatefichier .

Get(ITurnContext)

Obtient une copie des données brutes mises en cache depuis BotState le contexte du tour.

GetCachedState(ITurnContext)

Obtient l’instance d’état du bot mise en cache qui enveloppe les données brutes en cache depuis BotState le contexte du turn.

GetPropertyValueAsync<T>(ITurnContext, String, CancellationToken)

Obtient la valeur d’une propriété à partir du cache d’état pour cette BotStatefonction .

GetStorageKey(ITurnContext)

En cas de substitution dans une classe dérivée, obtient la clé à utiliser lors de la lecture et de l’écriture de l’état dans et depuis le stockage.

LoadAsync(ITurnContext, Boolean, CancellationToken)

Remplit le cache d’état depuis BotState la couche de stockage.

SaveChangesAsync(ITurnContext, Boolean, CancellationToken)

Écrit le cache d’état de cela BotState dans la couche de stockage.

SetPropertyValueAsync(ITurnContext, String, Object, CancellationToken)

Définit la valeur d’une propriété dans le cache d’état pour ce BotState.

S’applique à

Voir aussi