本地存储 API

借助本地存储 API，可将数据直接存储在本地浏览器中。 在本地存储数据会更加安全，并可提高 Web 应用的性能。

本地存储是独立的，因此每种类型的视觉对象都有其自己单独的存储访问权限。

如何使用本地存储

在以下示例中，只有调用 update 方法，计数器值就会增加。 计数器值保存在本地，并在每次启动视觉对象时调用。 这样，每次启动视觉对象时，计数器就会从停止的地方开始计数，而不是从头开始：

TypeScript复制

export class Visual implements IVisual {        // ...
        private updateCountName: string = 'updateCount';        
        private updateCount: number;        
        private storage: ILocalVisualStorageService;        // ...

        constructor(options: VisualConstructorOptions) {            // ...
            this.storage = options.host.storageService;            // ...

            this.storage.get(this.updateCountName).then(count =>
            {                this.updateCount = +count;
            })
            .catch(() =>
            {                
            this.updateCount = 0;                
            this.storage.set(this.updateCountName, this.updateCount.toString());
            });            // ...
        }        public update(options: VisualUpdateOptions) {            // ...
            this.updateCount++;            
            this.storage.set(this.updateCountName, 
            this.updateCount.toString());            // ...
        }
}

注意事项和限制

• 本地存储限制为每个 GUID 1mb。

• 只能在具有相同 GUID 的视觉对象之间共享数据。

• 不能与 Power BI Desktop 的其他实例共享数据。

• 默认情况下，本地存储 API 处于未激活状态。 要为 Power BI 视觉对象激活它，请将请求发送到 Power BI 视觉对象支持团队 pbicvsupport@microsoft.com。

• 本地存储 API 不支持 await 构造。 仅允许 than 和 catch 方法。 视觉对象应在 AppSource 中可用且经过认证。