*********************
*小数典 - V1.0.0.1 *
*********************
一、需要定义单位唯一号AppID,选择版本V10-V50之间AppVER,向群里申请授权码16位APPSEC。得到这三个信息才可以使用本类库。
二、应用示例:
1、初始化App权限信息
从未用则用上述三信息实例化一个AppInfo。
AppInfo api = new AppInfo("AppID", "AppVER", "AppSEC");
若原来使用过并保存到文件则用下面方式加载:
AppInfo api = AppInfo.Load("app.lic");
该方式是通过
AppInfo.Save("app.lic", api);
之后用生成的文件加载生成AppInfo实例。
2、初始化工作类SmallData
使用任何功能前先用AppInfo实例来初始化
SmallDataDict.SmallData.Init(api);//初始化
用完之后用
SmallData.Clear();
来清理缓存权限信息
3、工作类使用
使用之前使用
SmallDataDict.SmallData ss = new SmallDataDict.SmallData(AppID);//实例化一个工作类
(1)获得单位信息项目清单(1000个以内)
string[] list=ss.LoadSaveKeyList(true,new string[] { });//true是获得列表,false是更新项目列表,当为false时,其后的数组元素量必须>0个。
如:
ss.LoadSaveKeyList(false, new string[] {"Moto1","Temp2","Power3" });
需要注意的时,此保存功能,只是以添加的方式添加到原来有的列表中。
此操作不具备并存锁,此操作需要大约0.5-5秒的时间完成,如果此时间有并发提交保存则不保证保存的实例都成功。
(2)取得信息项目数据
if (!ss.GetData(项目名称, out string value, out string error))//如果失败则返回error原因,value=空,如果成功则error空,value是数据内容
{
MessageBox.Show(error, "OUT", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
else
{
MessageBox.Show(value, "OUTd", MessageBoxButtons.OK, MessageBoxIcon.Information);
}
(3)更新信息项目数据
if (!ss.SetData(项目名称, 项目数据, out string error))//如果失败。则返回失败原因
{
MessageBox.Show(error,"IN",MessageBoxButtons.OK,MessageBoxIcon.Error);
}
else
{
MessageBox.Show("更新成功", "IN", MessageBoxButtons.OK, MessageBoxIcon.Information);
}
(4)删除数据项目及内容
if(ss.DeleteData(项目名称,out string error))//如果项目名称=null,则删除本单位所有的数据项目及内容,相当于清空,如果不为空则删除指定项目名称的数据。
{
MessageBox.Show("删除成功!","OUT", MessageBoxButtons.OK, MessageBoxIcon.Information);
}
else
{
MessageBox.Show(error, "OUT", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
(5)由于数据信息在内存常驻,若无意外停电,数据一般都在,但不排除有意外发生,因此,本类库提供一个备份和还原数据的功能,可以定期操作。
还原功能:
if (!ss.LoadSaveData(out string error,false))//false是还原的意思,true是备份的意思。如果之前备份过,执行此操作则读取备份出来用。如果操作失败则返回error
{
MessageBox.Show(error, "OUT", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
else
{
MessageBox.Show("重置成功!", "OUT", MessageBoxButtons.OK, MessageBoxIcon.Information);
}
备份功能:
if(!ss.LoadSaveData(out string error))//默认是备份,如果失败则返回error
{
MessageBox.Show(error, "OUT", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
else
{
MessageBox.Show("保存成功!", "OUT", MessageBoxButtons.OK, MessageBoxIcon.Information);
}
(6)内容特别内容
标题和LOGO图标:
this.Text = SmallData.Title;//标题,包括名称-单位名称-版本如:小数典 - LAPTOPSVDURF99 - V1.0.0.1
btnLogo.Image = Image.FromStream(new MemoryStream(SmallData.Image));//包括一张64*64图标的图片字节数组,用它可以生成LOGO图标。
这两项内容只读,不同的类库文件可能有所不同。
(7)注意事项
本类库对数据进行加密会增加实际存储长度,因此,数据长度尽量短。能不长尽量不长。如果发生存成功却读不出来则表示数据长度或者数据内容有意外情况。则修改数据长库和敏感内容再试!
特别要记得本地备份自己的数据,并定期的通过类库方法备份数据。
由于项目名称总长度有限制,因此,项目名称越短,项目数目就存得越多。因此尽量简化自己的项目名称的命名长度。以存得更多项目数量。
本类库的编译是.NET Standard 2.0支持所有的.NET版本。
点击链接加入群聊【小数典】:https://qm.qq.com/q/uSmCtLJhHG