SyncConfigurationBase 类

SyncConfigurationBase用于设置Realm ，该 Realm 可以使用 Atlas Device Sync 在设备之间进行同步。 有两种同步模式及其各自的配置 - 使用PartitionSyncConfiguration的“分区”同步允许您将数据分割为单独的分区并将整个分区与整个 Realm 同步；使用FlexibleSyncConfiguration的“灵活”同步允许您从空 Realm 开始，并向服务器发送一组查询，服务器运行这些查询并使用所有匹配它们的文档填充 Realm。

继承
对象
RealmConfigurationBase
SyncConfigurationBase
FlexibleSyncConfiguration
PartitionSyncConfiguration
继承成员
命名空间： Realm 。 Sync
程序集：Realm.dll
语法
public abstract class SyncConfigurationBase : RealmConfigurationBase

属性

| 编辑本页 查看源代码

CancelAsyncOperationsOnNonFatalErrors

获取或设置一个值，该值指示异步操作（例如GetInstanceAsync(RealmConfigurationBase?, CancellationToken) 、 WaitForUploadAsync(CancellationToken?)或WaitForDownloadAsync(CancellationToken?) ）在发生非致命错误（例如超时）时是否应引发错误。

声明
public bool CancelAsyncOperationsOnNonFatalErrors { get; set; }
属性值
类型 说明
bool

true 如果发生非致命会话错误，则引发错误，否则为false 。
备注

如果设置为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

将同步其 Realm 的 用户 。

另请参阅