InspectionState class

Paquet:

botbuilder

Avertissement

Cette API est à présent déconseillée.

This class will be removed in a future version of the framework.

InspectionState à utiliser par InspectionMiddleware pour l’inspection de l’émulateur des activités d’exécution et botState.

Extends

BotState

Remarques

InspectionState à utiliser par InspectionMiddleware pour l’inspection de l’émulateur des activités d’exécution et botState.

Constructeurs

InspectionState(Storage)

Crée une instance de la classe InspectionState .

Méthodes héritées

clear(TurnContext)	Efface l’objet d’état actuel pour un tour.
createProperty<T>(string)	Crée un accesseur de propriété pour la lecture et l’écriture d’une propriété individuelle dans l’objet de stockage des états du bot.
delete(TurnContext)	Supprimez l’objet d’état de stockage pour le tour actuel.
get(TurnContext)	Retourne un objet d’état mis en cache ou non défini s’il n’est pas mis en cache.
load(TurnContext, boolean)	Lit et met en cache l’objet d’état de stockage pour un tour.
saveChanges(TurnContext, boolean)	Enregistre l’objet d’état mis en cache s’il a été modifié.

Détails du constructeur

InspectionState(Storage)

Crée une instance de la classe InspectionState .

new InspectionState(storage: Storage)

Paramètres

storage

Storage

La couche Stockage couche cet objet de gestion d’état sera utilisé pour stocker et récupérer l’état.

Détails de la méthode héritée

clear(TurnContext)

Efface l’objet d’état actuel pour un tour.

function clear(context: TurnContext): Promise<void>

Paramètres

context

TurnContext

Contexte pour le tour de conversation actuel avec l’utilisateur.

Retours

Promise<void>

Promesse représentant l’opération asynchrone.

Remarques

L’objet d’état effacé n’est pas conservé tant que saveChanges() a été appelé.

await botState.clear(context);
await botState.saveChanges(context);

héritée de BotState.clear

createProperty<T>(string)

Crée un accesseur de propriété pour la lecture et l’écriture d’une propriété individuelle dans l’objet de stockage des états du bot.

function createProperty<T>(name: string): StatePropertyAccessor<T>

Paramètres

name

string

Nom de la propriété à ajouter.

Retours

StatePropertyAccessor<T>

Accesseur pour la propriété.

héritée de BotState.createProperty

delete(TurnContext)

Supprimez l’objet d’état de stockage pour le tour actuel.

function delete(context: TurnContext): Promise<void>

Paramètres

context

TurnContext

Contexte pour le tour de conversation actuel avec l’utilisateur.

Retours

Promise<void>

Promesse représentant l’opération asynchrone.

Remarques

L’objet d’état est supprimé du stockage s’il existe. Si l’objet d’état a été lu et mis en cache, le cache est effacé.

await botState.delete(context);

héritée de BotState.delete

get(TurnContext)

Retourne un objet d’état mis en cache ou non défini s’il n’est pas mis en cache.

function get(context: TurnContext): any | undefined

Paramètres

context

TurnContext

Contexte pour le tour de conversation actuel avec l’utilisateur.

Retours

any | undefined

Objet d’état mis en cache ou non défini s’il n’est pas mis en cache.

Remarques

Cet exemple montre comment obtenir de façon synchrone un objet d’état déjà chargé et mis en cache :

const state = botState.get(context);

héritée de BotState.get

load(TurnContext, boolean)

Lit et met en cache l’objet d’état de stockage pour un tour.

function load(context: TurnContext, force?: boolean): Promise<any>

Paramètres

context

TurnContext

Contexte pour le tour de conversation actuel avec l’utilisateur.

force

boolean

(Facultatif) Si true le cache est contourné et que l’état est toujours lu directement à partir du stockage. La valeur par défaut est false.

Retours

Promise<any>

État mis en cache.

Remarques

Les lectures suivantes retournent l’objet mis en cache, sauf si l’indicateur force est passé, ce qui forcera la réécriture de l’objet d’état.

Cette méthode est automatiquement appelée sur le premier accès de l’un des accesseurs de propriété créés.

const state = await botState.load(context);

héritée de BotState.load

saveChanges(TurnContext, boolean)

Enregistre l’objet d’état mis en cache s’il a été modifié.

function saveChanges(context: TurnContext, force?: boolean): Promise<void>

Paramètres

context

TurnContext

Contexte pour le tour de conversation actuel avec l’utilisateur.

force

boolean

(Facultatif) si true l’état est toujours écrit, quel que soit son état de modification. La valeur par défaut est false.

Retours

Promise<void>

Promesse représentant l’opération asynchrone.

Remarques

Si l’indicateur de force est passé dans l’objet d’état mis en cache est enregistré, indépendamment de sa modification ou non et si aucun objet n’a été mis en cache, un objet vide est créé, puis enregistré.

await botState.saveChanges(context);

héritée de BotState.saveChanges