# 应用程序的数据存储 **AppStorage**是应用程序中的单例对象，由UI框架在应用程序启动时创建，在应用程序退出退出时销毁，为应用程序范围内的可变状态属性提供中央存储。**AppStorage**包含整个应用程序中需要访问的所有状态属性，只要应用程序保持运行，**AppStorage**就会保存所有属性及属性值，属性值可以通过唯一的键值进行访问。 UI组件可以通过装饰器将应用程序状态数据与**AppStorage**进行同步，应用业务逻辑的实现也可以通过接口访问**AppStorage**。 **AppStorage**的选择状态属性可以与不同的数据源或数据接收器同步，这些数据源和接收器可以是设备上的本地或远程，并具有不同的功能，如数据持久性。这样的数据源和接收器可以独立于UI在业务逻辑中实现。 默认情况下，**AppStorage**中的属性是可变的，**AppStorage**还可使用不可变（只读）属性。 ## AppStorage接口

方法

参数说明

返回值

定义

SetAndLink

key: string,

defaultValue: T

@Link

与Link接口类似，如果当前的key保存于AppStorage，则返回该key对应的value。如果该key未被创建，则创建一个对应default值的Link返回。

Set

key: string,

newValue: T

void

对已保存的key值，替换其value值。

Link

key: string

@Link

如果存在具有给定键的数据，则返回到此属性的双向数据绑定，该双向绑定意味着变量或者组件对数据的更改将同步到AppStorage，通过AppStorage对数据的修改将同步到变量或者组件。如果具有此键的属性不存在或属性为只读，则返回undefined。

SetAndProp

propName: string,

defaultValue: S

@Prop

与Prop接口类似，如果当前的key保存于AppStorage，则返回该key对应的value。如果该key未被创建，则创建一个对应default值的Prop返回。

Prop

key: string

@Prop

如果存在具有给定键的属性，则返回此属性的单向数据绑定。该单向绑定意味着只能通过AppStorage将属性的更改同步到变量或者组件。该方法返回的变量为不可变变量，适用于可变和不可变的状态属性，如果具有此键的属性不存在则返回undefined。

说明：

prop方法对应的属性值类型为简单类型。

SetOrCreate

key: string,

newValue: T

boolean

如果相同名字的属性存在：如果此属性可以被更改返回true，否则返回false。

如果相同名字的属性不存在：创建第一个赋值为defaultValue的属性，不支持null和undefined。

Get

key: string

T或undefined

通过此接口获取对应key值的value。

Has

propName: string

boolean

判断对应键值的属性是否存在。

Keys

void

array<string>

返回包含所有键的字符串数组。

Delete

key: string

boolean

删除key指定的键值对，如果存在且删除成功返回true，不存在或删除失败返回false。

Clear

void

boolean

删除所有的属性，如果当前有状态变量依旧引用此属性，则返回false。

IsMutable

key: string

boolean

返回此属性是否存在并且是否可以改变。
>![](../../public_sys-resources/icon-note.gif) **说明：** >当前接口当前仅可以处理基础类型数据，对于修改object中某一个值尚未支持。 ## AppStorage与组件同步 在[管理组件拥有的状态](ts-component-states-state.md)中，已经定义了如何将组件的状态变量与父组件或祖先组件中的**@State**装饰的状态变量同步，主要包括**@Prop**、**@Link**、**@Consume**。 本章节将定义如何将组件变量与**AppStorage**同步，主要提供**@StorageLink**和**@StorageProp**装饰器。 ### @StorageLink装饰器 组件通过使用**@StorageLink\(key\)**装饰的状态变量，与**AppStorage**建立双向数据绑定，**key**为**AppStorage**中的属性键值。当创建包含**@StorageLink**的状态变量的组件时，该状态变量的值将使用**AppStorage**中的值进行初始化。在UI组件中对**@StorageLink**的状态变量所做的更改将同步到**AppStorage**，并从**AppStorage**同步到任何其他绑定实例中，如**PersistentStorage**或其他绑定的UI组件。 ### @StorageProp装饰器 组件通过使用**@StorageProp\(key\)**装饰的状态变量，将与**AppStorage**建立单向数据绑定，**key**标识AppStorage中的属性键值。当创建包含**@StoageProp**的状态变量的组件时，该状态变量的值将使用**AppStorage**中的值进行初始化。**AppStorage**中的属性值的更改会导致绑定的UI组件进行状态更新。 ## 示例 ``` let varA = AppStorage.Link('varA') let envLang = AppStorage.Prop('languageCode') @Entry @Component struct ComponentA { @StorageLink('varA') varA: number = 2 @StorageProp('languageCode') lang: string = 'en' private label: string = 'count' private aboutToAppear() { this.label = (this.lang === 'zh') ? '数' : 'Count' } build() { Row({ space: 20 }) { Button(`${this.label}: ${this.varA}`) .onClick(() => { AppStorage.Set('varA', AppStorage.Get('varA') + 1) }) Button(`lang: ${this.lang}`) .onClick(() => { if (this.lang === 'zh') { AppStorage.Set('languageCode', 'en') } else { AppStorage.Set('languageCode', 'zh') } this.label = (this.lang === 'zh') ? '数' : 'Count' }) } } } ``` 每次开发者单击Count按钮时，this.varA变量值都会增加，此变量与AppStorage中的varA同步。每次用户单击当前语言按钮时，修改AppStorage中的languageCode，此修改会同步给this.lang变量。