Preferences.Flush 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

强制更改此首选项节点的内容及其后代到持久性存储。

[Android.Runtime.Register("flush", "()V", "GetFlushHandler")]
public abstract void Flush ();

[<Android.Runtime.Register("flush", "()V", "GetFlushHandler")>]
abstract member Flush : unit -> unit

如果支持存储不可用或导致操作失败，

强制更改此首选项节点的内容及其后代到持久性存储。此方法成功返回后，可以放心地假定在方法调用之前在此节点的子树中所做的所有更改都已永久化。

实现可以随时将更改刷新到持久性存储中。无需等待调用此方法。

在新创建的节点上发生刷新时，会将其持久化，任何尚未持久化祖先（和后代）也一样。但请注意，上级中的任何首选项值更改都 不能保证 持久化。

如果在已使用 #removeNode() 该方法删除的节点上调用此方法，则会在此节点上调用 flushSpi（），但不在此节点上调用其他方法。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。