共用方式為


StatePropertyAccessor interface

定義方法,以存取在 BotState 物件中建立的狀態屬性。

備註

若要在狀態管理 objet 中建立狀態屬性,請使用 createProperty<T> 方法。

方法

delete(TurnContext)

從其備份記憶體物件中刪除保存的屬性。

get(TurnContext)

從其備份記憶體物件讀取保存的屬性。

get(TurnContext, T)
set(TurnContext, T)

將新的值指派給備份記憶體物件的屬性。

方法詳細資料

delete(TurnContext)

從其備份記憶體物件中刪除保存的屬性。

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

參數

context
TurnContext

目前與使用者交談回合的內容。

傳回

Promise<void>

備註

備份記憶體對象的屬性應該在第一次存取時載入記憶體。

await myProperty.delete(context);

get(TurnContext)

從其備份記憶體物件讀取保存的屬性。

function get(context: TurnContext): Promise<T | undefined>

參數

context
TurnContext

目前與使用者交談回合的內容。

傳回

Promise<T | undefined>

備註

備份記憶體對象的屬性應該在第一次存取時載入記憶體。

如果儲存物件上目前不存在 屬性,且已指定 defaultValue,則應該將 defaultValue 的複本複製到記憶體物件。 如果未指定 defaultValue,則應該傳回 undefined 的值。

const value = await myProperty.get(context, { count: 0 });

get(TurnContext, T)

function get(context: TurnContext, defaultValue: T): Promise<T>

參數

context
TurnContext
defaultValue

T

傳回

Promise<T>

set(TurnContext, T)

將新的值指派給備份記憶體物件的屬性。

function set(context: TurnContext, value: T): Promise<void>

參數

context
TurnContext

目前與使用者交談回合的內容。

value

T

要指派的值。

傳回

Promise<void>

備註

備份記憶體對象的屬性應該在第一次存取時載入記憶體。

視狀態系統實作而定,可能需要額外的步驟,才能將實際變更保存到磁碟。

await myProperty.set(context, value);