InspectionState class

Pacchetto:

botbuilder

Avviso

Questa API è ora deprecata.

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

InspectionState per l'uso da parte di InspectionMiddleware per l'ispezione dell'emulatore delle attività di runtime e di BotState.

Extends

BotState

Commenti

InspectionState per l'uso da parte di InspectionMiddleware per l'ispezione dell'emulatore delle attività di runtime e di BotState.

Costruttori

InspectionState(Storage)

Crea una nuova istanza della classe InspectionState.

Metodi ereditati

clear(TurnContext)	Cancella l'oggetto di stato corrente per un turno.
createProperty<T>(string)	Crea una nuova funzione di accesso alle proprietà per la lettura e la scrittura di una singola proprietà nell'oggetto di archiviazione degli stati del bot.
delete(TurnContext)	Eliminare l'oggetto stato di backup per il turno corrente.
get(TurnContext)	Restituisce un oggetto di stato memorizzato nella cache o non definito se non memorizzato nella cache.
load(TurnContext, boolean)	Legge e memorizza nella cache l'oggetto stato di backup per un turno.
saveChanges(TurnContext, boolean)	Salva l'oggetto stato memorizzato nella cache se è stato modificato.

Dettagli costruttore

InspectionState(Storage)

Crea una nuova istanza della classe InspectionState.

new InspectionState(storage: Storage)

Parametri

storage

Storage

Il livello di archiviazione questo oggetto di gestione dello stato verrà usato per archiviare e recuperare lo stato.

Dettagli dei metodi ereditati

clear(TurnContext)

Cancella l'oggetto di stato corrente per un turno.

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

Parametri

context

TurnContext

Contesto per il turno corrente della conversazione con l'utente.

Restituisce

Promise<void>

Promessa che rappresenta l'operazione asincrona.

Commenti

L'oggetto stato cancellato non verrà salvato in modo permanente finché non viene chiamato saveChanges().

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

Ereditato da BotState.clear

createProperty<T>(string)

Crea una nuova funzione di accesso alle proprietà per la lettura e la scrittura di una singola proprietà nell'oggetto di archiviazione degli stati del bot.

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

Parametri

name

string

Nome della proprietà da aggiungere.

Restituisce

StatePropertyAccessor<T>

Funzione di accesso per la proprietà .

Ereditato da BotState.createProperty

delete(TurnContext)

Eliminare l'oggetto stato di backup per il turno corrente.

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

Parametri

context

TurnContext

Contesto per il turno corrente della conversazione con l'utente.

Restituisce

Promise<void>

Promessa che rappresenta l'operazione asincrona.

Commenti

L'oggetto stato verrà rimosso dalla risorsa di archiviazione, se presente. Se l'oggetto di stato è stato letto e memorizzato nella cache, la cache verrà cancellata.

await botState.delete(context);

ereditato da BotState.delete

get(TurnContext)

Restituisce un oggetto di stato memorizzato nella cache o non definito se non memorizzato nella cache.

function get(context: TurnContext): any | undefined

Parametri

context

TurnContext

Contesto per il turno corrente della conversazione con l'utente.

Restituisce

any | undefined

Oggetto di stato memorizzato nella cache o non definito se non memorizzato nella cache.

Commenti

Questo esempio mostra come ottenere in modo sincrono un oggetto stato già caricato e memorizzato nella cache:

const state = botState.get(context);

ereditato da BotState.get

load(TurnContext, boolean)

Legge e memorizza nella cache l'oggetto stato di backup per un turno.

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

Parametri

context

TurnContext

Contesto per il turno corrente della conversazione con l'utente.

force

boolean

(Facoltativo) Se true la cache verrà ignorata e lo stato verrà sempre letto direttamente dall'archiviazione. Il valore predefinito è false.

Restituisce

Promise<any>

Stato memorizzato nella cache.

Commenti

Le letture successive restituiranno l'oggetto memorizzato nella cache, a meno che non venga passato il flag force che forza la ri lettura dell'oggetto di stato.

Questo metodo viene chiamato automaticamente al primo accesso di una delle funzioni di accesso alle proprietà create.

const state = await botState.load(context);

ereditato da BotState.load

saveChanges(TurnContext, boolean)

Salva l'oggetto stato memorizzato nella cache se è stato modificato.

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

Parametri

context

TurnContext

Contesto per il turno corrente della conversazione con l'utente.

force

boolean

(Facoltativo) se true lo stato verrà sempre scritto indipendentemente dal relativo stato di modifica. Il valore predefinito è false.

Restituisce

Promise<void>

Promessa che rappresenta l'operazione asincrona.

Commenti

Se il flag force viene passato nell'oggetto stato memorizzato nella cache verrà salvato indipendentemente dal fatto che sia stato modificato o meno e se non è stato memorizzato nella cache alcun oggetto, verrà creato e salvato un oggetto vuoto.

await botState.saveChanges(context);

Ereditato da BotState.saveChanges