Preferences.ImportPreferences(Stream) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Imports all of the preferences represented by the XML document on the specified input stream.
[Android.Runtime.Register("importPreferences", "(Ljava/io/InputStream;)V", "")]
public static void ImportPreferences (System.IO.Stream? is);
[<Android.Runtime.Register("importPreferences", "(Ljava/io/InputStream;)V", "")>]
static member ImportPreferences : System.IO.Stream -> unit
Parameters
- is
- Stream
the input stream from which to read the XML document.
- Attributes
Exceptions
if the data read from the given input stream is not from a valid XML document.
if an error occurs while importing.
Remarks
Imports all of the preferences represented by the XML document on the specified input stream. The document may represent user preferences or system preferences. If it represents user preferences, the preferences will be imported into the calling user's preference tree (even if they originally came from a different user's preference tree). If any of the preferences described by the document inhabit preference nodes that do not exist, the nodes will be created.
The XML document must have the following DOCTYPE declaration:
{@code
<!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd">
}
(This method is designed for use in conjunction with #exportNode(OutputStream)
and #exportSubtree(OutputStream)
.
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. The method behaves as if implemented on top of the other public methods in this class, notably #node(String)
and #put(String, String)
.
Java documentation for java.util.prefs.Preferences.importPreferences(java.io.InputStream)
.
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.