StatePropertyAccessor interface
定義方法,以存取在 BotState 物件中建立的狀態屬性。
備註
若要在狀態管理 objet 中建立狀態屬性,請使用 createProperty<T> 方法。
方法
| delete(Turn |
從其備份記憶體物件中刪除保存的屬性。 |
| get(Turn |
從其備份記憶體物件讀取保存的屬性。 |
| get(Turn |
|
| set(Turn |
將新的值指派給備份記憶體物件的屬性。 |
方法詳細資料
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);