Condividi tramite

XamlReader.LoadAsync Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Markup
Assembly:
PresentationFramework.dll

Legge il markup XAML e restituisce un oggetto che corrisponde alla radice del markup specificato.

Overload

LoadAsync(Stream, ParserContext, Boolean)
LoadAsync(XmlReader, Boolean)
LoadAsync(Stream, ParserContext)

Legge l'input XAML nell'oggetto Stream specificato e restituisce la radice della struttura ad albero di oggetti corrispondente.
LoadAsync(Stream)

Legge l'input XAML nell'oggetto Stream specificato e restituisce la radice della struttura ad albero di oggetti corrispondente.
LoadAsync(XmlReader)

Legge l'input XAML nell'oggetto XmlReader specificato e restituisce la radice della struttura ad albero di oggetti corrispondente.
LoadAsync(Stream, Boolean)

LoadAsync(Stream, ParserContext, Boolean) 

public:
 System::Object ^ LoadAsync(System::IO::Stream ^ stream, System::Windows::Markup::ParserContext ^ parserContext, bool useRestrictiveXamlReader);
public object LoadAsync (System.IO.Stream stream, System.Windows.Markup.ParserContext parserContext, bool useRestrictiveXamlReader);
member this.LoadAsync : System.IO.Stream * System.Windows.Markup.ParserContext * bool -> obj
Public Function LoadAsync (stream As Stream, parserContext As ParserContext, useRestrictiveXamlReader As Boolean) As Object

Parametri

stream
Stream
parserContext
ParserContext
useRestrictiveXamlReader
Boolean

Restituisce

Object

Commenti

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Load(Stream, ParserContext, Boolean).

Si applica a

LoadAsync(XmlReader, Boolean) 

public:
 System::Object ^ LoadAsync(System::Xml::XmlReader ^ reader, bool useRestrictiveXamlReader);
public object LoadAsync (System.Xml.XmlReader reader, bool useRestrictiveXamlReader);
member this.LoadAsync : System.Xml.XmlReader * bool -> obj
Public Function LoadAsync (reader As XmlReader, useRestrictiveXamlReader As Boolean) As Object

Parametri

reader
XmlReader
useRestrictiveXamlReader
Boolean

Restituisce

Object

Commenti

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Load(XmlReader, Boolean).

Si applica a

LoadAsync(Stream, ParserContext)

Legge l'input XAML nell'oggetto Stream specificato e restituisce la radice della struttura ad albero di oggetti corrispondente.

public:
 System::Object ^ LoadAsync(System::IO::Stream ^ stream, System::Windows::Markup::ParserContext ^ parserContext);
public object LoadAsync (System.IO.Stream stream, System.Windows.Markup.ParserContext parserContext);
member this.LoadAsync : System.IO.Stream * System.Windows.Markup.ParserContext -> obj
Public Function LoadAsync (stream As Stream, parserContext As ParserContext) As Object

Parametri

stream
Stream

Flusso contenente l'input XAML da caricare.

parserContext
ParserContext

Informazioni di contesto utilizzate dal parser.

Restituisce

Object

Radice della struttura ad albero di oggetti creata.

Eccezioni

ArgumentNullException

stream è null.

InvalidOperationException

Più operazioni di caricamento sono eseguite contemporaneamente con lo stesso XamlReader.

Commenti

Un'operazione di caricamento XAML asincrona restituirà inizialmente un oggetto che è puramente l'oggetto radice. In modo asincrono, l'analisi XAML continua e tutti gli oggetti figlio vengono compilati sotto la radice. In contrasto con il tipico comportamento di elaborazione XAML WPF e la relativa interazione con i concetti di durata dell'oggetto WPF. Nell'interazione tipica (non asincrona) tutte le proprietà di un oggetto, incluse tutte le raccolte figlio, vengono riempite prima di restituire un elemento e segnalarlo come caricato. Tale comportamento equivale a una metodologia di fondo per la creazione dell'albero in cui l'oggetto radice è l'ultimo oggetto da rendere disponibile.

In genere si assegna l'oggetto restituito a una posizione nell'albero degli oggetti dell'applicazione, con la conoscenza che il contenuto potrebbe comunque essere compilato e potrebbe causare aggiornamenti incrementali del layout se l'intero contenuto viene esposto come parte dell'interfaccia utente. Per questo motivo, è tipico isolare o virtualizzare gli oggetti caricati in modo asincrono da XAML e usare la logica o lo stato dell'applicazione specifici dell'applicazione per notificare quando LoadCompleted viene gestito.

LoadAsync Per caricare il markup in modo asincrono, l'elemento radice nel markup XAML deve contenere l'attributo e il valore x:SynchronousMode="Async". Il valore viene considerato come distinzione tra maiuscole e minuscole. Se la radice del markup XAML non contiene x:SynchronousMode="Async", non viene generata alcuna eccezione e la chiamata viene elaborata come carico sincrono (vedere Load(Stream, ParserContext)).

È possibile eseguire una sola operazione di caricamento asincrona per ogni istanza della XamlReader classe. Se viene generata più di un'operazione asincrona nella stessa istanza della XamlReader classe.InvalidOperationException

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Load(Stream, ParserContext).

Vedi anche

Si applica a

LoadAsync(Stream)

Legge l'input XAML nell'oggetto Stream specificato e restituisce la radice della struttura ad albero di oggetti corrispondente.

public:
 System::Object ^ LoadAsync(System::IO::Stream ^ stream);
public object LoadAsync (System.IO.Stream stream);
member this.LoadAsync : System.IO.Stream -> obj
Public Function LoadAsync (stream As Stream) As Object

Parametri

stream
Stream

Flusso contenente l'input XAML da caricare.

Restituisce

Object

Oggetto che sarà la radice della struttura ad albero di oggetti creata.

Eccezioni

ArgumentNullException

stream è null.

InvalidOperationException

Più operazioni di caricamento sono lasciate in sospeso contemporaneamente con lo stesso XamlReader.

Commenti

Un'operazione di caricamento XAML asincrona restituirà inizialmente un oggetto che è puramente l'oggetto radice. In modo asincrono, l'analisi XAML continua e tutti gli oggetti figlio vengono compilati sotto la radice. In contrasto con il tipico comportamento di elaborazione XAML WPF e la relativa interazione con i concetti di durata dell'oggetto WPF. Nell'interazione tipica (non asincrona) tutte le proprietà di un oggetto, incluse tutte le raccolte figlio, vengono riempite prima di restituire un elemento e segnalarlo come caricato. Tale comportamento equivale a una metodologia di fondo per la creazione dell'albero in cui l'oggetto radice è l'ultimo oggetto da rendere disponibile.

In genere si assegna l'oggetto restituito a una posizione nell'albero degli oggetti dell'applicazione WPF, con la conoscenza che il contenuto potrebbe comunque essere compilato e potrebbe causare aggiornamenti incrementali del layout se l'intero contenuto viene esposto come parte dell'interfaccia utente. Per questo motivo, è tipico isolare o virtualizzare gli oggetti caricati in modo asincrono da XAML e usare la logica o lo stato dell'applicazione specifici dell'applicazione per notificare quando LoadCompleted viene gestito.

Per LoadAsync caricare l'input XAML in modo asincrono, l'elemento radice nell'input XAML deve contenere l'attributo e il valore x:SynchronousMode="Async". Il valore viene considerato come distinzione tra maiuscole e minuscole. Se la radice di input XAML non contiene x:SynchronousMode="Async", non viene generata alcuna eccezione e la chiamata viene elaborata come carico sincrono (vedere Load(Stream)).

È possibile eseguire una sola operazione di caricamento asincrona per ogni istanza della XamlReader classe. Se viene generata più di un'operazione asincrona nella stessa istanza della XamlReader classe.InvalidOperationException

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Load(Stream).

Vedi anche

Si applica a

LoadAsync(XmlReader)

Legge l'input XAML nell'oggetto XmlReader specificato e restituisce la radice della struttura ad albero di oggetti corrispondente.

public:
 System::Object ^ LoadAsync(System::Xml::XmlReader ^ reader);
public object LoadAsync (System.Xml.XmlReader reader);
member this.LoadAsync : System.Xml.XmlReader -> obj
Public Function LoadAsync (reader As XmlReader) As Object

Parametri

reader
XmlReader

Oggetto esistente XmlReader già caricato/letto l'input XAML.

Restituisce

Object

Radice della struttura ad albero di oggetti creata.

Eccezioni

ArgumentNullException

reader è null.

InvalidOperationException

Più operazioni di caricamento sono eseguite contemporaneamente con lo stesso XamlReader.

Commenti

Un'operazione di caricamento XAML asincrona restituirà inizialmente un oggetto che è puramente l'oggetto radice. In modo asincrono, l'analisi XAML continua e tutti gli oggetti figlio vengono compilati sotto la radice. In contrasto con il tipico comportamento di elaborazione XAML WPF e la relativa interazione con i concetti di durata dell'oggetto WPF. Nell'interazione tipica (non asincrona) tutte le proprietà di un oggetto, incluse tutte le raccolte figlio, vengono riempite prima di restituire un elemento e segnalarlo come caricato. Tale comportamento equivale a una metodologia di fondo per la creazione dell'albero in cui l'oggetto radice è l'ultimo oggetto da rendere disponibile.

In genere si assegna l'oggetto restituito da LoadAsync a una posizione nell'albero degli oggetti dell'applicazione, con la conoscenza che il contenuto potrebbe comunque essere compilato e potrebbe causare aggiornamenti incrementali del layout se l'intero contenuto viene esposto come parte dell'interfaccia utente. Per questo motivo, è tipico isolare o virtualizzare gli oggetti caricati in modo asincrono da XAML e usare la logica o lo stato dell'applicazione specifici dell'applicazione per notificare quando LoadCompleted viene gestito.

LoadAsync Per caricare l'input XAML in modo asincrono, l'elemento radice nel markup XAML deve contenere l'attributo e il valore x:SynchronousMode="Async". Il valore viene considerato come distinzione tra maiuscole e minuscole. Se la radice del markup XAML non contiene x:SynchronousMode="Async", non viene generata alcuna eccezione e la chiamata viene invece elaborata come carico sincrono (vedere Load(XmlReader)).

È possibile eseguire una sola operazione di caricamento asincrona per ogni istanza della XamlReader classe. Se viene generata più di un'operazione asincrona nella stessa istanza della XamlReader classe.InvalidOperationException

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Load(XmlReader).

Vedi anche

Si applica a

LoadAsync(Stream, Boolean) 

public:
 System::Object ^ LoadAsync(System::IO::Stream ^ stream, bool useRestrictiveXamlReader);
public object LoadAsync (System.IO.Stream stream, bool useRestrictiveXamlReader);
member this.LoadAsync : System.IO.Stream * bool -> obj
Public Function LoadAsync (stream As Stream, useRestrictiveXamlReader As Boolean) As Object

Parametri

stream
Stream
useRestrictiveXamlReader
Boolean

Restituisce

Object

Commenti

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Load(Stream, Boolean).

Si applica a