XamlServices.Load Metodo

Definizione

Spazio dei nomi:

System.Xaml

Assembly:

System.Xaml.dll

Carica l'origine per un reader XAML e scrive l'output come oggetto grafico.

Overload

Load(Stream)	Carica un'origine Stream per un reader XAML e scrive l'output come oggetto grafico.
Load(TextReader)	Crea un reader XAML da un oggetto TextReader e restituisce un oggetto grafico.
Load(String)	Carica un'origine Stream per un reader XAML e restituisce un oggetto grafico.
Load(XamlReader)	Carica un'implementazione specifica del reader XAML e restituisce un oggetto grafico.
Load(XmlReader)	Carica un'implementazione specifica del reader XML e restituisce un oggetto grafico.

Load(Stream)

Carica un'origine Stream per un reader XAML e scrive l'output come oggetto grafico.

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

Parametri

stream

Stream

Flusso da caricare come input.

Restituisce

Object

Oggetto grafico scritto come output.

Eccezioni

ArgumentNullException

stream è null.

Commenti

Firme diverse per il Load(Stream) metodo specificano diversi tipi di input per il codice XAML di origine. L'implementazione Load(Stream) interna crea innanzitutto un oggetto XmlReader chiamando Create(Stream) e quindi crea una nuova istanza di un oggetto specializzato XamlReader che elabora l'input.

Affinché la Load(Stream) chiamata crei correttamente un oggetto grafico, è necessario che sia true quanto segue:

• L'origine è in formato corretto e xml valido.

• L'origine è XAML valido a livello di linguaggio.

• I tipi XAML specificati nel codice XAML di origine devono essere risolti nei tipi di supporto negli spazi dei nomi XAML pertinenti. Ad esempio, i tipi XAML per gli spazi dei nomi WPF possono essere risolti in uno spazio dei nomi XAML WPF come specificato in XAML; gli assembly per WPF devono essere inclusi nel progetto o disponibili in fase di esecuzione; E così via.

Importante

XamlServicesnon è il set di API di lettura XAML consigliato o scrittura XAML se si elaborano tipi Windows Presentation Foundation (WPF) o tipi basati su WPF. Per l'utilizzo di WPF, usare System.Windows.Markup.XamlReader per la lettura o il caricamento di XAML e System.Windows.Markup.XamlWriter per la scrittura di XAML. Queste classi usano System.Xaml le API internamente nell'implementazione, ma forniscono anche il supporto per i concetti specifici di WPF che influenzano la natura della lettura e della scrittura XAML, ad esempio le ottimizzazioni per le proprietà di dipendenza.

Load(TextReader)

Crea un reader XAML da un oggetto TextReader e restituisce un oggetto grafico.

public:
 static System::Object ^ Load(System::IO::TextReader ^ textReader);

public static object Load (System.IO.TextReader textReader);

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

Public Shared Function Load (textReader As TextReader) As Object

Parametri

textReader

TextReader

Oggetto TextReader da utilizzare come base per l'oggetto XmlReader creato.

Restituisce

Object

Oggetto grafico restituito.

Eccezioni

ArgumentNullException

textReader è null.

Commenti

Per restituire l'oggetto grafico, l'input textReader deve essere costruito usando il relativo input pertinente. Ad esempio, deve passare un oggetto StringReader costruito usando un input XAML come stringa valido per il StringReader(String) costruttore.

Load(String)

Carica un'origine Stream per un reader XAML e restituisce un oggetto grafico.

public:
 static System::Object ^ Load(System::String ^ fileName);

public static object Load (string fileName);

static member Load : string -> obj

Public Shared Function Load (fileName As String) As Object

Parametri

fileName

String

Nome file da caricare e utilizzare come origine.

Restituisce

Object

Oggetto grafico restituito.

Eccezioni

ArgumentNullException

L'input del fileName è null.

Commenti

Firme diverse per il Load metodo specificano diversi tipi di input per il codice XAML di origine. L'implementazione Load interna crea innanzitutto un oggetto XmlReader chiamando Create(String) e quindi crea una nuova istanza di un oggetto specializzato XamlReader che elabora l'input.

Affinché la Load(String) chiamata crei correttamente un oggetto grafico, è necessario che sia true quanto segue:

• L'origine è in formato corretto e xml valido.

• L'origine è XAML valido a livello di linguaggio.

• I tipi XAML specificati nel codice XAML di origine devono essere risolti nei tipi di supporto negli spazi dei nomi XAML pertinenti. Ad esempio, i tipi XAML per gli spazi dei nomi WPF possono essere risolti in uno spazio dei nomi XAML WPF come specificato in XAML; gli assembly per WPF devono essere inclusi nel progetto o essere disponibili in fase di esecuzione; E così via.

Load(XamlReader)

Carica un'implementazione specifica del reader XAML e restituisce un oggetto grafico.

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

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

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

Public Shared Function Load (xamlReader As XamlReader) As Object

Parametri

xamlReader

XamlReader

Implementazione del reader XAML da utilizzare come reader per l'operazione Load.

Restituisce

Object

Oggetto grafico restituito.

Eccezioni

ArgumentNullException

L'input del xamlReader è null.

Commenti

In genere è consigliabile usare questa firma solo nei casi seguenti:

• È stata definita la propria implementazione di un oggetto XamlReader.

• Sono state specificate impostazioni per un oggetto XamlReader che differiscono dalle impostazioni predefinite.

Load(XmlReader)

Carica un'implementazione specifica del reader XML e restituisce un oggetto grafico.

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

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

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

Public Shared Function Load (xmlReader As XmlReader) As Object

Parametri

xmlReader

XmlReader

Implementazione XmlReader da utilizzare come reader per l'operazione Load.

Restituisce

Object

Oggetto grafico di output.

Eccezioni

ArgumentNullException

L'input del xamlReader è null.

Commenti

In genere è consigliabile usare questa firma solo se è stata definita la propria implementazione di un oggetto XmlReader.