InspectionState class

Paket:

botbuilder

Warnung

Diese API ist nun veraltet.

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

InspectionState für die Verwendung durch die InspectionMiddleware zur Emulatorüberprüfung von Laufzeitaktivitäten und BotState.

Extends

BotState

Hinweise

InspectionState für die Verwendung durch die InspectionMiddleware zur Emulatorüberprüfung von Laufzeitaktivitäten und BotState.

Konstruktoren

InspectionState(Storage)

Erstellt eine neue Instanz der InspectionState Klasse.

Geerbte Methoden

clear(TurnContext)	Löscht das aktuelle Zustandsobjekt für eine Drehung.
createProperty<T>(string)	Erstellt einen neuen Eigenschaftsaccessor zum Lesen und Schreiben einer einzelnen Eigenschaft in das Bot-Statusspeicherobjekt.
delete(TurnContext)	Löschen Sie das Sicherungsstatusobjekt für die aktuelle Drehung.
get(TurnContext)	Gibt ein zwischengespeichertes Statusobjekt oder nicht definiert zurück, wenn es nicht zwischengespeichert wurde.
load(TurnContext, boolean)	Liest das Sicherungszustandsobjekt für eine Drehung in und speichert es zwischen.
saveChanges(TurnContext, boolean)	Speichert das zwischengespeicherte Zustandsobjekt, wenn es geändert wurde.

Details zum Konstruktor

InspectionState(Storage)

Erstellt eine neue Instanz der InspectionState Klasse.

new InspectionState(storage: Storage)

Parameter

storage

Storage

Das Storage Layer dieses Zustandsverwaltungsobjekt verwendet, um den Zustand zu speichern und abzurufen.

Details zur geerbten Methode

clear(TurnContext)

Löscht das aktuelle Zustandsobjekt für eine Drehung.

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

Parameter

context

TurnContext

Kontext für die aktuelle Unterhaltungswende mit dem Benutzer.

Gibt zurück

Promise<void>

Eine Zusage, die den asynchronen Vorgang darstellt.

Hinweise

Das gelöschte Zustandsobjekt wird erst beibehalten, wenn saveChanges() aufgerufen wurde.

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

Von BotState.clear geerbt

createProperty<T>(string)

Erstellt einen neuen Eigenschaftsaccessor zum Lesen und Schreiben einer einzelnen Eigenschaft in das Bot-Statusspeicherobjekt.

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

Parameter

name

string

Der Name der hinzuzufügenden Eigenschaft.

Gibt zurück

StatePropertyAccessor<T>

Ein Accessor für die Eigenschaft.

Geerbt von BotState.createProperty

delete(TurnContext)

Löschen Sie das Sicherungsstatusobjekt für die aktuelle Drehung.

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

Parameter

context

TurnContext

Kontext für die aktuelle Unterhaltungswende mit dem Benutzer.

Gibt zurück

Promise<void>

Eine Zusage, die den asynchronen Vorgang darstellt.

Hinweise

Das Statusobjekt wird aus dem Speicher entfernt, wenn es vorhanden ist. Wenn das Statusobjekt gelesen und zwischengespeichert wurde, wird der Cache gelöscht.

await botState.delete(context);

von BotState.delete geerbt

get(TurnContext)

Gibt ein zwischengespeichertes Statusobjekt oder nicht definiert zurück, wenn es nicht zwischengespeichert wurde.

function get(context: TurnContext): any | undefined

Parameter

context

TurnContext

Kontext für die aktuelle Unterhaltungswende mit dem Benutzer.

Gibt zurück

any | undefined

Ein zwischengespeichertes Statusobjekt oder nicht definiert, wenn es nicht zwischengespeichert wird.

Hinweise

In diesem Beispiel wird gezeigt, wie Sie synchron ein bereits geladenes und zwischengespeichertes Zustandsobjekt abrufen:

const state = botState.get(context);

Geerbt von BotState.get

load(TurnContext, boolean)

Liest das Sicherungszustandsobjekt für eine Drehung in und speichert es zwischen.

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

Parameter

context

TurnContext

Kontext für die aktuelle Unterhaltungswende mit dem Benutzer.

force

boolean

(Optional) Wenn true der Cache umgangen wird und der Zustand immer direkt aus dem Speicher gelesen wird. Standardmäßig wird false.

Gibt zurück

Promise<any>

Der zwischengespeicherte Zustand.

Hinweise

Nachfolgende Lesevorgänge geben das zwischengespeicherte Objekt zurück, es sei denn, das force Flag wird übergeben, in dem das Zustandsobjekt erneut gelesen werden muss.

Diese Methode wird automatisch für den ersten Zugriff einer erstellten Eigenschaftsaccessoren aufgerufen.

const state = await botState.load(context);

geerbt von BotState.load

saveChanges(TurnContext, boolean)

Speichert das zwischengespeicherte Zustandsobjekt, wenn es geändert wurde.

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

Parameter

context

TurnContext

Kontext für die aktuelle Unterhaltungswende mit dem Benutzer.

force

boolean

(Optional) wenn true der Zustand unabhängig vom Änderungszustand immer ausgeschrieben wird. Standardmäßig wird false.

Gibt zurück

Promise<void>

Eine Zusage, die den asynchronen Vorgang darstellt.

Hinweise

Wenn das force Flag im zwischengespeicherten Zustandsobjekt übergeben wird, unabhängig davon, ob es geändert wurde oder nicht, und wenn kein Objekt zwischengespeichert wurde, wird ein leeres Objekt erstellt und dann gespeichert.

await botState.saveChanges(context);

Geerbt von BotState.saveChanges