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

Restituisce

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

Restituisce

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

Restituisce

Radice della struttura ad albero di oggetti creata.

Eccezioni

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

• 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

Restituisce

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

Eccezioni

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

• 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

Restituisce

Radice della struttura ad albero di oggetti creata.

Eccezioni

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

• 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

Restituisce

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