04.应用存档

创建你的存档

应用的存档由ESave进行管理，默认是不创建的，如果需要创建，请转到应用窗口的Form_Load过程，将注释有“创建存档”的部分的注释符号删去。
存档使用ESave.Create进行创建，默认不提供key,使用存档前请务必设置您的存档key。

ESave.Create 参数解说

参数名	类型	说明
name	String	存档名称，请不要选择太过于常见的名字，防止和其他应用的存档发生冲突。
[optional] BMKey	String	验证存档所使用的秘钥。

NOTE:
请在代码中妥善做好秘钥的保密，防止秘钥被窃取。
如果想不出该使用什么秘钥，可以在立即面板中输入Debug.Print GetBMKey来获取秘钥。
一旦设置后，请不要修改你的秘钥，否则将导致应用存档完全丢失。

使用存档

你可以使用ESave.GetData获取存档数据，并使用ESave.PutData设置存档数据。

ESave.GetData 参数解说

参数名	类型	说明
name	String	数据名称

NOTE：
这是一个函数。当指定的存档数据不存在时将返回空字符串。

ESave.PutData 参数解说

参数名	类型	说明
name	String	数据名称
value	String	数据值

NOTE:
如果您开启了自动存档，请不要频繁修改数据。

ESave.Save 解说

该方法将会保存你的存档到磁盘。
该方法不需要任何参数。

自动存档

Emerald提供了自动存档功能，在你每次修改存档数据后都会进行存档。
自动存档的开启方法如下：

ESave.AutoSave = True

存档数据项管理（不常用）

ESave.Count

返回值：Long
说明：取得存档内数据项的总个数。

ESave.GetName

返回值：String
参数：

• Index 类型：Integer
  说明：指定存档数据项的序号

说明：取得指定编号的数据项的名称。

ESave.Path

类型：String
说明：存档保存在磁盘上的位置。

注意：请不要修改这个位置。