XamlServices.Load Metodo

Definizione

Spazio dei nomi:: System.Xaml

Assembly:: System.Xaml.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Overload

Nome	Descrizione
Load(Stream)	Carica un'origine Stream per un lettore XAML e scrive il relativo output come oggetto grafico.
Load(TextReader)	Crea un lettore XAML da un TextReaderoggetto e restituisce un oggetto grafico.
Load(String)	Carica un'origine Stream per un lettore XAML e restituisce un oggetto grafico.
Load(XamlReader)	Carica un'implementazione specifica del lettore XAML e restituisce un oggetto grafico.
Load(XmlReader)	Carica un'implementazione specifica del lettore XML e restituisce un oggetto grafico.

Load(Stream)

Carica un'origine Stream per un lettore XAML e scrive il relativo 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.

Valori restituiti

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 risolvere i tipi di supporto negli spazi dei nomi XAML pertinenti. Ad esempio, i tipi XAML per gli spazi dei nomi macchine virtuali Windows possono essere risolti in uno spazio dei nomi XAML macchine virtuali Windows come specificato nel codice XAML; gli assembly per macchine virtuali Windows devono essere inclusi nel progetto o disponibili in fase di esecuzione e così via.

Importante

XamlServices non è il set di API di lettura XAML consigliato o scrittura XAML se si elaborano tipi windows Presentation Foundation (macchine virtuali Windows) o tipi basati su macchine virtuali Windows. Per l'utilizzo di macchine virtuali Windows, 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 internamente le API nella loro implementazione, ma forniscono anche supporto per i concetti specifici di macchine virtuali Windows che influiscono sulla natura della lettura e della scrittura XAML, ad esempio ottimizzazioni per le proprietà di dipendenza.

Si applica a

Load(TextReader)

Crea un lettore XAML da un TextReaderoggetto 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 creato XmlReader.

Valori restituiti

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.

Si applica a

Load(String)

Carica un'origine Stream per un lettore 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 del file da caricare e usare come origine.

Valori restituiti

Object

Oggetto grafico restituito.

Eccezioni

ArgumentNullException

fileName input è 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 risolvere i tipi di supporto negli spazi dei nomi XAML pertinenti. Ad esempio, i tipi XAML per gli spazi dei nomi macchine virtuali Windows possono essere risolti in uno spazio dei nomi XAML macchine virtuali Windows come specificato in XAML; gli assembly per macchine virtuali Windows devono essere inclusi nel progetto o essere disponibili in fase di esecuzione e così via.

Si applica a

Load(XamlReader)

Carica un'implementazione specifica del lettore 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 lettore XAML da usare come lettore per questa Load operazione.

Valori restituiti

Object

Oggetto grafico restituito.

Eccezioni

ArgumentNullException

xamlReader input è null.

Commenti

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

È stata definita la propria implementazione di un oggetto XamlReader.
Sono state specificate le impostazioni per un oggetto XamlReader che differiscono dalle impostazioni predefinite.

Si applica a

Load(XmlReader)

Carica un'implementazione specifica del lettore 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 usare come lettore per questa Load operazione.

Valori restituiti

Object

Oggetto grafico dell'output.

Eccezioni

ArgumentNullException

xmlReader input è null.

Commenti

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

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?