XamlReader.Load Method

Reference

Definition

Namespace:: System.Windows.Markup

Assembly:: PresentationFramework.dll

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.

Reads XAML input and returns the root of the corresponding object tree.

Overloads

Load(Stream)	Reads the XAML input in the specified Stream and returns an Object that is the root of the corresponding object tree.
Load(XamlReader)	Reads the XAML input through a provided XamlReader and returns an object that is the root of the corresponding object tree.
Load(XmlReader)	Reads the XAML input in the specified XmlReader and returns an object that is the root of the corresponding object tree.
Load(Stream, Boolean)
Load(Stream, ParserContext)	Reads the XAML input in the specified Stream and returns an object that is the root of the corresponding object tree.
Load(XmlReader, Boolean)
Load(Stream, ParserContext, Boolean)

Load(Stream)

Reads the XAML input in the specified Stream and returns an Object that is the root of the corresponding object tree.

public:
 static System::Object ^ Load(System::IO::Stream ^ stream);

public static object Load(System.IO.Stream stream);

static member Load : System.IO.Stream -> obj

Public Shared Function Load (stream As Stream) As Object

Parameters

stream: Stream

The XAML to load, in stream form.

Returns

Object

The object at the root of the created object tree.

Exceptions

ArgumentNullException

stream is null.

Examples

The following example saves a Button into a MemoryStream using the XamlWriter class. The stream is then loaded back into a Button using the static Load method on the XamlReader class.

// Create the Button.
Button originalButton = new Button();
originalButton.Height = 50;
originalButton.Width = 100;
originalButton.Background = Brushes.AliceBlue;
originalButton.Content = "Click Me";

// Save the Button to a string.
string savedButton = XamlWriter.Save(originalButton);

// Load the button
StringReader stringReader = new StringReader(savedButton);
XmlReader xmlReader = XmlReader.Create(stringReader);
Button readerLoadButton = (Button)XamlReader.Load(xmlReader);

' Create the Button.
Dim originalButton As New Button()
originalButton.Height = 50
originalButton.Width = 100
originalButton.Background = Brushes.AliceBlue
originalButton.Content = "Click Me"

' Save the Button to a string.
Dim savedButton As String = XamlWriter.Save(originalButton)

' Load the button
Dim stringReader As New StringReader(savedButton)
Dim xmlReader As XmlReader = XmlReader.Create(stringReader)
Dim readerLoadButton As Button = CType(XamlReader.Load(xmlReader), Button)

Applies to

.NET Framework 4.8.1 an aner Versiounen

Produkt	Versiounen
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Load(XamlReader)

Reads the XAML input through a provided XamlReader and returns an object that is the root of the corresponding object tree.

public:
 static System::Object ^ Load(System::Xaml::XamlReader ^ reader);

public static object Load(System.Xaml.XamlReader reader);

static member Load : System.Xaml.XamlReader -> obj

Public Shared Function Load (reader As XamlReader) As Object

Parameters

reader: XamlReader

A XamlReader object. This is expected to be initialized with input XAML.

Returns

Object

The object that is the root of the created object tree.

Exceptions

ArgumentNullException

reader is null.

Remarks

The input XamlReader can be Baml2006Reader. This is how you can load BAML at run time, or for localization tool purposes.

Applies to

.NET Framework 4.8.1 an aner Versiounen

Produkt	Versiounen
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Load(XmlReader)

Reads the XAML input in the specified XmlReader and returns an object that is the root of the corresponding object tree.

public:
 static System::Object ^ Load(System::Xml::XmlReader ^ reader);

public static object Load(System.Xml.XmlReader reader);

static member Load : System.Xml.XmlReader -> obj

Public Shared Function Load (reader As XmlReader) As Object

Parameters

reader: XmlReader

The XmlReader that has already loaded the XAML input to load in XML form.

Returns

Object

The object that is the root of the created object tree.

Exceptions

ArgumentNullException

reader is null.

Examples

The following example converts a Button into a string using the XamlWriter class. The string is then loaded back into a Button using the static Load method on the XamlReader class.

// Create the Button.
Button originalButton = new Button();
originalButton.Height = 50;
originalButton.Width = 100;
originalButton.Background = Brushes.AliceBlue;
originalButton.Content = "Click Me";

// Save the Button to a string.
string savedButton = XamlWriter.Save(originalButton);

// Load the button
StringReader stringReader = new StringReader(savedButton);
XmlReader xmlReader = XmlReader.Create(stringReader);
Button readerLoadButton = (Button)XamlReader.Load(xmlReader);

' Create the Button.
Dim originalButton As New Button()
originalButton.Height = 50
originalButton.Width = 100
originalButton.Background = Brushes.AliceBlue
originalButton.Content = "Click Me"

' Save the Button to a string.
Dim savedButton As String = XamlWriter.Save(originalButton)

' Load the button
Dim stringReader As New StringReader(savedButton)
Dim xmlReader As XmlReader = XmlReader.Create(stringReader)
Dim readerLoadButton As Button = CType(XamlReader.Load(xmlReader), Button)

Applies to

.NET Framework 4.8.1 an aner Versiounen

Produkt	Versiounen
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Load(Stream, Boolean)

public:
 static System::Object ^ Load(System::IO::Stream ^ stream, bool useRestrictiveXamlReader);

public static object Load(System.IO.Stream stream, bool useRestrictiveXamlReader);

static member Load : System.IO.Stream * bool -> obj

Public Shared Function Load (stream As Stream, useRestrictiveXamlReader As Boolean) As Object

Parameters

stream: Stream

useRestrictiveXamlReader: Boolean

Returns

Object

Applies to

Windows Desktop 10 an aner Versiounen

Produkt	Versiounen
Windows Desktop	5, 6, 7, 8, 9, 10

Load(Stream, ParserContext)

Reads the XAML input in the specified Stream and returns an object that is the root of the corresponding object tree.

public:
 static System::Object ^ Load(System::IO::Stream ^ stream, System::Windows::Markup::ParserContext ^ parserContext);

public static object Load(System.IO.Stream stream, System.Windows.Markup.ParserContext parserContext);

static member Load : System.IO.Stream * System.Windows.Markup.ParserContext -> obj

Public Shared Function Load (stream As Stream, parserContext As ParserContext) As Object

Parameters

stream: Stream

The stream that contains the XAML input to load.

parserContext: ParserContext

Context information used by the parser.

Returns

Object

The object that is the root of the created object tree.

Exceptions

ArgumentNullException

stream is null.

-or-

parserContext is null.

Applies to

.NET Framework 4.8.1 an aner Versiounen

Produkt	Versiounen
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Load(XmlReader, Boolean)

public:
 static System::Object ^ Load(System::Xml::XmlReader ^ reader, bool useRestrictiveXamlReader);

public static object Load(System.Xml.XmlReader reader, bool useRestrictiveXamlReader);

static member Load : System.Xml.XmlReader * bool -> obj

Public Shared Function Load (reader As XmlReader, useRestrictiveXamlReader As Boolean) As Object

Parameters

reader: XmlReader

useRestrictiveXamlReader: Boolean

Returns

Object

Applies to

Windows Desktop 10 an aner Versiounen

Produkt	Versiounen
Windows Desktop	5, 6, 7, 8, 9, 10

Load(Stream, ParserContext, Boolean)

public:
 static System::Object ^ Load(System::IO::Stream ^ stream, System::Windows::Markup::ParserContext ^ parserContext, bool useRestrictiveXamlReader);

public static object Load(System.IO.Stream stream, System.Windows.Markup.ParserContext parserContext, bool useRestrictiveXamlReader);

static member Load : System.IO.Stream * System.Windows.Markup.ParserContext * bool -> obj

Public Shared Function Load (stream As Stream, parserContext As ParserContext, useRestrictiveXamlReader As Boolean) As Object

Parameters

stream: Stream

parserContext: ParserContext

useRestrictiveXamlReader: Boolean

Returns

Object

Applies to

Windows Desktop 10 an aner Versiounen

Produkt	Versiounen
Windows Desktop	5, 6, 7, 8, 9, 10

Deelen iwwer

XamlReader.Load Method

Definition

Overloads

Load(Stream)

Parameters

Returns

Exceptions

Examples

See also

Applies to

Load(XamlReader)

Parameters

Returns

Exceptions

Remarks

Applies to

Load(XmlReader)

Parameters

Returns

Exceptions

Examples

See also

Applies to

Load(Stream, Boolean)

Parameters

Returns

Applies to

Load(Stream, ParserContext)

Parameters

Returns

Exceptions

See also

Applies to

Load(XmlReader, Boolean)

Parameters

Returns

Applies to

Load(Stream, ParserContext, Boolean)

Parameters

Returns

Applies to

Zousätzlech Ressourcen