类 DiscardUnsyncedChangesHandler
一种客户端重置策略,其中所有尚未同步的数据将被自动丢弃,并获取已同步 Realm 的全新副本。
命名空间: Realms 。同步。 ErrorHandling
程序集:Realm.dll
语法
public sealed class DiscardUnsyncedChangesHandler : ClientResetHandlerBase
备注
在内部模拟写事务时,新下载的同步 Realm 副本会触发所有变更通知。 此策略提供三个回调: OnBeforeReset 、 OnAfterReset和ManualResetFallback 。 前两个函数是在客户端重置前后调用的,而最后一个函数则是在自动化过程中发生错误且系统需要回退到手动模式时调用的。 使用此策略的总体建议是,仅在以下情况下才应考虑使用这三个可用的回调:
- 需要(在OnBeforeReset中)通知用户未同步数据的传入潜在数据丢失
- 需要(在OnAfterReset中)通知用户重置过程已完成
- 数据敏感应用程序的高级使用案例,在这些应用程序中,开发者希望以最适当的方式恢复未同步的数据
- 在客户端重置发生之前(在OnBeforeReset中)备份整个域。例如,此类备份可用于恢复未同步的数据(请参阅 3。)
属性
| 编辑本页 查看源代码ManualResetFallback
获取或设置发生导致操作无法完成的错误时触发的回调,例如发生破坏性模式更改时。
声明
public ClientResetHandlerBase.ClientResetCallback? ManualResetFallback { get; set; }
属性值
类型 | 说明 |
---|---|
ClientResetHandlerBase 。 ClientResetCallback | 如果自动客户端重置处理失败,则调用回调。 |
OnAfterReset
获取或设置指示刚刚发生客户端重置的回调。
声明
public ClientResetHandlerBase.AfterResetCallback? OnAfterReset { get; set; }
属性值
类型 | 说明 |
---|---|
ClientResetHandlerBase 。 AfterResetCallback | 客户端重置后立即调用的回调。 |
OnBeforeReset
获取或设置指示即将发生客户端重置的回调。
声明
public ClientResetHandlerBase.BeforeResetCallback? OnBeforeReset { get; set; }
属性值
类型 | 说明 |
---|---|
ClientResetHandlerBase 。 BeforeResetCallback | 在客户端重置之前调用的回调。 |