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 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour 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 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour 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 façon asynchrone, l’analyse XAML se poursuit, et tous les objets enfants sont renseignés sous la racine. Contrairement au comportement de traitement XAML classique WPF et à son interaction avec WPF concepts 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 de bas en haut pour créer l’arborescence où l’objet racine est le dernier objet à mettre à disposition.

En règle générale, vous affectez l’objet retourné à un emplacement dans l’arborescence d’objets de votre application, avec la connaissance que le contenu peut toujours 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 il LoadCompleted est géré.

Pour charger LoadAsync le balisage de manière asynchrone, l’élément racine du 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(Stream, ParserContext)).

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

Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour 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 façon asynchrone, l’analyse XAML se poursuit, et tous les objets enfants sont renseignés sous la racine. Contrairement au comportement de traitement XAML classique WPF et à son interaction avec WPF concepts 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 de bas en haut pour créer l’arborescence où l’objet racine est le dernier objet à mettre à disposition.

En règle générale, vous affectez l'objet retourné à un emplacement dans l'arborescence d'objets de votre application WPF, avec la connaissance que le contenu peut toujours 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 il LoadCompleted est géré.

Pour charger LoadAsync l’entrée 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 l’appel est traité comme une charge synchrone (voir Load(Stream)).

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

Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour 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 façon asynchrone, l’analyse XAML se poursuit, et tous les objets enfants sont renseignés sous la racine. Contrairement au comportement de traitement XAML classique WPF et à son interaction avec WPF concepts 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 de bas en haut pour créer l’arborescence où l’objet racine est le dernier objet à mettre à disposition.

En règle générale, vous affectez l’objet retourné à partir d’un LoadAsync emplacement dans l’arborescence d’objets de votre application, avec les connaissances que le contenu peut toujours 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 il LoadCompleted est géré.

Pour charger LoadAsync l’entrée XAML de manière asynchrone, l’élément racine du 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é en tant que charge synchrone (voir Load(XmlReader)).

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

Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour 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 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Load(Stream, Boolean).