SyncConfigurationBase 类
SyncConfigurationBase用于设置Realm ,该 Realm 可以使用 Atlas Device Sync 在设备之间进行同步。 有两种同步模式及其各自的配置 - 使用PartitionSyncConfiguration的“分区”同步允许您将数据分割为单独的分区并将整个分区与整个 Realm 同步;使用FlexibleSyncConfiguration的“灵活”同步允许您从空 Realm 开始,并向服务器发送一组查询,服务器运行这些查询并使用所有匹配它们的文档填充 Realm。
继承
继承成员
命名空间: Realm 。 Sync
程序集:Realm.dll
语法
public abstract class SyncConfigurationBase : RealmConfigurationBase
属性
| 编辑本页 查看源代码CancelAsyncOperationsOnNonFatalErrors
获取或设置一个值,该值指示异步操作(例如GetInstanceAsync(RealmConfigurationBase?, CancellationToken) 、 WaitForUploadAsync(CancellationToken?)或WaitForDownloadAsync(CancellationToken?) )在发生非致命错误(例如超时)时是否应引发错误。
声明
public bool CancelAsyncOperationsOnNonFatalErrors { get; set; }
属性值
类型 | 说明 |
---|---|
bool |
|
备注
如果设置为false
,则将忽略非致命会话错误,同步将继续在后台重试连接。 这意味着在设备离线的情况下,这些操作可能需要不确定的时间才能完成。
ClientResetHandler
获取或设置在此 Realm 发生客户端重置错误时将调用的处理程序。 默认为RecoverOrDiscardUnsyncedChangesHandler ,它会尝试自动恢复任何未同步的更改,如果失败,则继续丢弃未同步的更改。
声明
public virtual ClientResetHandlerBase ClientResetHandler { get; set; }
属性值
类型 | 说明 |
---|---|
ClientResetHandlerBase | 将用于处理客户端重置的ClientResetHandlerBase 。 |
备注
支持的值为RecoverOrDiscardUnsyncedChangesHandler 、 RecoverUnsyncedChangesHandler 、 DiscardUnsyncedChangesHandler和ManualRecoveryHandler的实例。 默认的RecoverOrDiscardUnsyncedChangesHandler不会为回调之前和之后设置自定义操作。
另请参阅
| 编辑本页 查看源代码EncryptionKey
获取或设置用于加密整个 Realm 的密钥。 设置后,必须在每次使用该文件时指定。
声明
public byte[]? EncryptionKey { get; set; }
属性值
类型 | 说明 |
---|---|
字节[] | 用于 AES-256 加密的完整 64 字节(512 位)密钥。 |
OnSessionError
获取或设置回调,每当同步 Realm 发生SessionException时都会调用该回调。
声明
public SyncConfigurationBase.SessionErrorCallback? OnSessionError { get; set; }
属性值
类型 | 说明 |
---|---|
SyncConfigurationBase 。 SessionErrorCallback | 将用于报告暂时性会话错误的SyncConfigurationBase.SessionErrorCallback 。 |
备注
客户端重置错误不会通过此回调报告,因为它们由设置的ClientResetHandler处理。
user
获取用于创建此 SyncConfigurationBase 的 User 。
声明
public User User { get; }
属性值
类型 | 说明 |
---|---|
user |