copy Realm

摘要 乐趣 <t : RealmObject> copyToRealm(实例: T , updatePolicy : UpdatePolicy = UpdatePolicy.ERROR): t

将新对象复制到 域 中或更新现有对象。

这会将对象递归复制到 Realm。 带主键和不带主键的主键。 复制具有主键的对象的行为取决于指定的更新策略。 使用UpdatePolicy.ERROR进行调用将禁止更新现有对象。 因此,如果已存在具有相同主键的对象,则会引发错误。 因此,设置此项意味着只能创建新对象。 使用UpdatePolicy.ALL调用意味着具有匹配主键的现有对象将使用输入对象的值更新其所有属性。

已经托管的 update-to-date 对象不会被复制,而只是返回实例本身。 尝试复制过时的对象会引发异常。 要获取对象的更新引用,请使用findLatest

返回

instance的托管版本。

参数

实例

要从中创建副本的对象。

更新 策略

导入对象时更新策略。

抛出异常

如果instance的对象图包含主键值已存在的对象且更新策略为UpdatePolicy.ERROR ,或者对象图包含先前版本的对象。