Udostępnij za pośrednictwem


Preferences.ExportSubtree(Stream) Method

Definition

Emits an XML document representing all of the preferences contained in this node and all of its descendants.

[Android.Runtime.Register("exportSubtree", "(Ljava/io/OutputStream;)V", "GetExportSubtree_Ljava_io_OutputStream_Handler")]
public abstract void ExportSubtree (System.IO.Stream? os);
[<Android.Runtime.Register("exportSubtree", "(Ljava/io/OutputStream;)V", "GetExportSubtree_Ljava_io_OutputStream_Handler")>]
abstract member ExportSubtree : System.IO.Stream -> unit

Parameters

os
Stream

the output stream on which to emit the XML document.

Attributes

Exceptions

if an error occurs while exporting.

if the backing store is unavailable or causes an operation failure.

if this node has been removed.

Remarks

Emits an XML document representing all of the preferences contained in this node and all of its descendants. This XML document is, in effect, an offline backup of the subtree rooted at the node.

The XML document will have the following DOCTYPE declaration:

{@code
<!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd">
            }

The UTF-8 character encoding will be used.

This method is an exception to the general rule that the results of concurrently executing multiple methods in this class yields results equivalent to some serial execution. If the preferences or nodes in the subtree rooted at this node are modified concurrently with an invocation of this method, the exported preferences comprise a "fuzzy snapshot" of the subtree; some of the concurrent modifications may be reflected in the exported data while others may not.

Java documentation for java.util.prefs.Preferences.exportSubtree(java.io.OutputStream).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to