XamlReader.LoadAsync Méthode

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

Retours

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

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

Retours

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

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

Retours

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

Exceptions

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

• 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

Paramètres

Retours

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

Exceptions

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

• 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

Paramètres

Retours

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

Exceptions

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

• 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

Paramètres

Retours

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