XamlReader.LoadAsync Metodo

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

Valori restituiti

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).

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

Valori restituiti

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).

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

Valori restituiti

Radice dell'albero degli oggetti creato.

Eccezioni

Commenti

Un'operazione di caricamento XAML asincrona restituirà inizialmente un oggetto puramente l'oggetto radice. In modo asincrono, l'analisi XAML continua e tutti gli oggetti figlio vengono compilati sotto la radice. Questo è in contrasto con il tipico comportamento di elaborazione XAML macchine virtuali Windows e la sua interazione con i concetti macchine virtuali Windows della durata degli oggetti. 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 consapevolezza che il contenuto potrebbe ancora 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 qualsiasi oggetto caricato in modo asincrono da XAML e usare la logica o lo stato dell'applicazione specifico dell'applicazione per notificare quando LoadCompleted viene gestito.

Per LoadAsync 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 di markup XAML non contiene x:SynchronousMode="Async", non viene generata alcuna eccezione e la chiamata viene elaborata come caricamento sincrono (vedere Load(Stream, ParserContext)).

È possibile eseguire una sola operazione di caricamento asincrona per ogni istanza della XamlReader classe alla volta. Se viene tentata più di un'operazione asincrona nella stessa istanza della XamlReader classe , viene generata un'eccezione 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

• XamlWriter

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

Valori restituiti

Oggetto che rappresenta la radice dell'albero di oggetti creato.

Eccezioni

Commenti

Un'operazione di caricamento XAML asincrona restituirà inizialmente un oggetto puramente l'oggetto radice. In modo asincrono, l'analisi XAML continua e tutti gli oggetti figlio vengono compilati sotto la radice. Questo è in contrasto con il tipico comportamento di elaborazione XAML macchine virtuali Windows e la sua interazione con i concetti macchine virtuali Windows della durata degli oggetti. 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 macchine virtuali Windows, con la consapevolezza che il contenuto potrebbe ancora 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 qualsiasi oggetto caricato in modo asincrono da XAML e usare la logica o lo stato dell'applicazione specifico 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 caricamento sincrono (vedere Load(Stream)).

È possibile eseguire una sola operazione di caricamento asincrona per ogni istanza della XamlReader classe alla volta. Se viene tentata più di un'operazione asincrona nella stessa istanza della XamlReader classe , viene generata un'eccezione 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

• XamlWriter

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

Valori restituiti

Radice dell'albero degli oggetti creato.

Eccezioni

Commenti

Un'operazione di caricamento XAML asincrona restituirà inizialmente un oggetto puramente l'oggetto radice. In modo asincrono, l'analisi XAML continua e tutti gli oggetti figlio vengono compilati sotto la radice. Questo è in contrasto con il tipico comportamento di elaborazione XAML macchine virtuali Windows e la sua interazione con i concetti macchine virtuali Windows della durata degli oggetti. 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 consapevolezza che il contenuto potrebbe ancora 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 qualsiasi oggetto caricato in modo asincrono da XAML e usare la logica o lo stato dell'applicazione specifico dell'applicazione per notificare quando LoadCompleted viene gestito.

Per LoadAsync 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 di markup XAML non contiene x:SynchronousMode="Async", non viene generata alcuna eccezione e la chiamata viene invece elaborata come caricamento sincrono (vedere Load(XmlReader)).

È possibile eseguire una sola operazione di caricamento asincrona per ogni istanza della XamlReader classe alla volta. Se viene tentata più di un'operazione asincrona nella stessa istanza della XamlReader classe , viene generata un'eccezione 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

• XamlWriter

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

Valori restituiti

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).