XamlReader.LoadAsync Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Markup
Assembly:
PresentationFramework.dll

Lit le balisage XAML et retourne un objet qui correspond à la racine du balisage spécifié.

Surcharges

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

Lit l'entrée XAML dans le Stream spécifié et retourne la racine de l'arborescence de l'objet correspondant.
LoadAsync(Stream)

Lit l'entrée XAML dans le Stream spécifié et retourne la racine de l'arborescence de l'objet correspondant.
LoadAsync(XmlReader)

Lit l'entrée XAML dans le XmlReader spécifié et retourne la racine de l'arborescence de l'objet correspondant.
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

Paramètres

stream
Stream
parserContext
ParserContext
useRestrictiveXamlReader
Boolean

Retours

Object

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Load(Stream, ParserContext, Boolean).

S’applique à

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

Paramètres

reader
XmlReader
useRestrictiveXamlReader
Boolean

Retours

Object

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Load(XmlReader, Boolean).

S’applique à

LoadAsync(Stream, ParserContext)

Lit l'entrée XAML dans le Stream spécifié et retourne la racine de l'arborescence de l'objet correspondant.

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

Paramètres

stream
Stream

Flux contenant l'entrée XAML à charger.

parserContext
ParserContext

Informations de contexte utilisées par l'analyseur.

Retours

Object

Racine de l'arborescence d'objets créée.

Exceptions

ArgumentNullException

stream a la valeur null.

InvalidOperationException

Plusieurs opérations de chargement sont réalisées simultanément avec le même XamlReader.

Remarques

Une opération de chargement XAML asynchrone retourne initialement un objet qui est purement l’objet racine. De manière asynchrone, l’analyse XAML continue, et tous les objets enfants sont renseignés sous la racine. Cela contraste avec le comportement de traitement XAML WPF classique et son interaction avec les concepts WPF de durée de vie des objets. Dans l’interaction classique (non asynchrone), toutes les propriétés d’un objet, y compris toutes les collections enfants, sont remplies avant de renvoyer un élément et de le signaler comme chargé. Ce comportement équivaut à une méthodologie ascendante pour créer l’arborescence où l’objet racine est le dernier objet à être disponible.

Vous affectez généralement l’objet retourné à un emplacement quelconque dans l’arborescence des objets de votre application, sachant que le contenu peut toujours se remplir et peut entraîner des mises à jour incrémentielles de la disposition si l’ensemble du contenu est exposé dans le cadre de l’interface utilisateur. Pour cette raison, il est courant d’isoler ou de virtualiser tous les objets chargés de manière asynchrone à partir de XAML, et d’utiliser une logique ou un état d’application spécifique à l’application pour notifier quand LoadCompleted est géré.

Pour LoadAsync charger le balisage de manière asynchrone, l’élément racine dans le balisage XAML doit contenir l’attribut et la valeur x:SynchronousMode="Async". La valeur est traitée comme respectant la casse. Si la racine de balisage XAML ne contient x:SynchronousMode="Async"pas , aucune exception n’est levée et que l’appel est traité comme une charge synchrone (voir Load(Stream, ParserContext)).

Une seule opération de chargement asynchrone par instance de la XamlReader classe peut être effectuée à la fois. Si plusieurs opérations asynchrones sont tentées sur le même instance de la XamlReader classe un InvalidOperationException est levée.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Load(Stream, ParserContext).

Voir aussi

S’applique à

LoadAsync(Stream)

Lit l'entrée XAML dans le Stream spécifié et retourne la racine de l'arborescence de l'objet correspondant.

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

Paramètres

stream
Stream

Flux contenant l'entrée XAML à charger.

Retours

Object

Objet qui est la racine de l'arborescence d'objets créée.

Exceptions

ArgumentNullException

stream a la valeur null.

InvalidOperationException

Plusieurs opérations de chargement sont en attente simultanément avec le même XamlReader.

Remarques

Une opération de chargement XAML asynchrone retourne initialement un objet qui est purement l’objet racine. De manière asynchrone, l’analyse XAML continue, et tous les objets enfants sont renseignés sous la racine. Cela contraste avec le comportement de traitement XAML WPF classique et son interaction avec les concepts WPF de durée de vie des objets. Dans l’interaction classique (non asynchrone), toutes les propriétés d’un objet, y compris toutes les collections enfants, sont remplies avant de renvoyer un élément et de le signaler comme chargé. Ce comportement équivaut à une méthodologie ascendante pour créer l’arborescence où l’objet racine est le dernier objet à être disponible.

Vous attribuez généralement l’objet retourné à un emplacement quelconque dans l’arborescence des objets de votre application WPF, sachant que le contenu peut toujours se remplir et peut entraîner des mises à jour de disposition incrémentielles si l’ensemble du contenu est exposé dans le cadre de l’interface utilisateur. Pour cette raison, il est courant d’isoler ou de virtualiser tous les objets chargés de manière asynchrone à partir de XAML, et d’utiliser une logique ou un état d’application spécifique à l’application pour notifier quand LoadCompleted est géré.

Pour charger l’entrée LoadAsync XAML de manière asynchrone, l’élément racine de l’entrée XAML doit contenir l’attribut et la valeur x:SynchronousMode="Async". La valeur est traitée comme respectant la casse. Si la racine d’entrée XAML ne contient x:SynchronousMode="Async"pas , aucune exception n’est levée et que l’appel est traité comme une charge synchrone (voir Load(Stream)).

Une seule opération de chargement asynchrone par instance de la XamlReader classe peut être effectuée à la fois. Si plusieurs opérations asynchrones sont tentées sur le même instance de la XamlReader classe un InvalidOperationException est levée.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Load(Stream).

Voir aussi

S’applique à

LoadAsync(XmlReader)

Lit l'entrée XAML dans le XmlReader spécifié et retourne la racine de l'arborescence de l'objet correspondant.

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

Paramètres

reader
XmlReader

Existant XmlReader qui a déjà chargé/lu l’entrée XAML.

Retours

Object

Racine de l'arborescence d'objets créée.

Exceptions

ArgumentNullException

reader a la valeur null.

InvalidOperationException

Plusieurs opérations de chargement sont réalisées simultanément avec le même XamlReader.

Remarques

Une opération de chargement XAML asynchrone retourne initialement un objet qui est purement l’objet racine. De manière asynchrone, l’analyse XAML continue, et tous les objets enfants sont renseignés sous la racine. Cela contraste avec le comportement de traitement XAML WPF classique et son interaction avec les concepts WPF de durée de vie des objets. Dans l’interaction classique (non asynchrone), toutes les propriétés d’un objet, y compris toutes les collections enfants, sont remplies avant de renvoyer un élément et de le signaler comme chargé. Ce comportement équivaut à une méthodologie ascendante pour créer l’arborescence où l’objet racine est le dernier objet à être disponible.

Vous attribuez généralement l’objet retourné à un LoadAsync emplacement dans l’arborescence des objets de votre application, sachant que le contenu peut toujours se remplir et peut entraîner des mises à jour de disposition incrémentielles si l’ensemble du contenu est exposé dans le cadre de l’interface utilisateur. Pour cette raison, il est courant d’isoler ou de virtualiser tous les objets chargés de manière asynchrone à partir de XAML, et d’utiliser une logique ou un état d’application spécifique à l’application pour notifier quand LoadCompleted est géré.

Pour charger l’entrée LoadAsync XAML de manière asynchrone, l’élément racine dans le balisage XAML doit contenir l’attribut et la valeur x:SynchronousMode="Async". La valeur est traitée comme respectant la casse. Si la racine de balisage XAML ne contient x:SynchronousMode="Async"pas , aucune exception n’est levée et l’appel est traité comme une charge synchrone (voir Load(XmlReader)).

Une seule opération de chargement asynchrone par instance de la XamlReader classe peut être effectuée à la fois. Si plusieurs opérations asynchrones sont tentées sur le même instance de la XamlReader classe un InvalidOperationException est levée.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Load(XmlReader).

Voir aussi

S’applique à

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

Paramètres

stream
Stream
useRestrictiveXamlReader
Boolean

Retours

Object

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Load(Stream, Boolean).

S’applique à