XamlReader.LoadAsync Método

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

Parâmetros

Retornos

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por 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

Parâmetros

Retornos

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por 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

Parâmetros

Retornos

A raiz da árvore de objetos criada.

Exceções

Comentários

Uma operação de carga XAML assíncrona retornará inicialmente um objeto que é puramente o objeto raiz. De forma assíncrona, a análise XAML continua e todos os objetos filho são preenchidos sob a raiz. Isso contrasta com o comportamento típico de processamento XAML do WPF e sua interação com os conceitos do WPF de tempo de vida do objeto. Na interação típica (não assíncrona), todas as propriedades de um objeto, incluindo todas as coleções filho, são preenchidas antes de retornar um elemento e reportá-lo como carregado. Esse comportamento equivale a uma metodologia de baixo para cima para criar a árvore em que o objeto raiz é o último objeto a ficar disponível.

Normalmente, você atribuiria o objeto retornado a algum local na árvore de objetos do aplicativo, com o conhecimento de que o conteúdo ainda pode estar preenchendo e pode causar atualizações de layout incrementais se todo o conteúdo for exposto como parte da interface do usuário. Por esse motivo, é comum isolar ou virtualizar objetos carregados de forma assíncrona do XAML e usar a lógica específica do aplicativo ou o estado do aplicativo para notificar quando LoadCompleted é manipulado.

Para LoadAsync carregar a marcação de forma assíncrona, o elemento raiz na marcação XAML deve conter o atributo e o valor x:SynchronousMode="Async". O valor é tratado como diferencial de maiúsculas de minúsculas. Se a raiz de marcação XAML não contiver x:SynchronousMode="Async", nenhuma exceção será gerada e a chamada será processada como uma carga síncrona (consulte Load(Stream, ParserContext)).

Somente uma operação de carga assíncrona por instância da XamlReader classe pode ser executada por vez. Se mais de uma operação assíncrona for tentada na mesma instância da XamlReader classe, uma InvalidOperationException será gerada.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Load(Stream, ParserContext).

Confira também

• 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

Parâmetros

Retornos

O objeto que é a raiz da árvore de objetos criada.

Exceções

Comentários

Uma operação de carga XAML assíncrona retornará inicialmente um objeto que é puramente o objeto raiz. De forma assíncrona, a análise XAML continua e todos os objetos filho são preenchidos sob a raiz. Isso contrasta com o comportamento típico de processamento XAML do WPF e sua interação com os conceitos do WPF de tempo de vida do objeto. Na interação típica (não assíncrona), todas as propriedades de um objeto, incluindo todas as coleções filho, são preenchidas antes de retornar um elemento e reportá-lo como carregado. Esse comportamento equivale a uma metodologia de baixo para cima para criar a árvore em que o objeto raiz é o último objeto a ficar disponível.

Normalmente, você atribuiria o objeto retornado a algum local na árvore de objetos do aplicativo WPF, com o conhecimento de que o conteúdo ainda pode estar preenchendo e pode causar atualizações de layout incrementais se todo o conteúdo for exposto como parte da interface do usuário. Por esse motivo, é comum isolar ou virtualizar objetos carregados de forma assíncrona do XAML e usar a lógica específica do aplicativo ou o estado do aplicativo para notificar quando LoadCompleted é manipulado.

Para LoadAsync carregar a entrada XAML de forma assíncrona, o elemento raiz na entrada XAML deve conter o atributo e o valor x:SynchronousMode="Async". O valor é tratado como diferencial de maiúsculas de minúsculas. Se a raiz de entrada XAML não contiver x:SynchronousMode="Async", nenhuma exceção será gerada e a chamada será processada como uma carga síncrona (consulte Load(Stream)).

Somente uma operação de carga assíncrona por instância da XamlReader classe pode ser executada por vez. Se mais de uma operação assíncrona for tentada na mesma instância da XamlReader classe, uma InvalidOperationException será gerada.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Load(Stream).

Confira também

• 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

Parâmetros

Retornos

A raiz da árvore de objetos criada.

Exceções

Comentários

Uma operação de carga XAML assíncrona retornará inicialmente um objeto que é puramente o objeto raiz. De forma assíncrona, a análise XAML continua e todos os objetos filho são preenchidos sob a raiz. Isso contrasta com o comportamento típico de processamento XAML do WPF e sua interação com os conceitos do WPF de tempo de vida do objeto. Na interação típica (não assíncrona), todas as propriedades de um objeto, incluindo todas as coleções filho, são preenchidas antes de retornar um elemento e reportá-lo como carregado. Esse comportamento equivale a uma metodologia de baixo para cima para criar a árvore em que o objeto raiz é o último objeto a ficar disponível.

Normalmente, você atribuiria o objeto retornado de LoadAsync a algum local na árvore de objetos do aplicativo, com o conhecimento de que o conteúdo ainda pode estar preenchendo e pode causar atualizações de layout incrementais se todo o conteúdo for exposto como parte da interface do usuário. Por esse motivo, é comum isolar ou virtualizar objetos carregados de forma assíncrona do XAML e usar a lógica específica do aplicativo ou o estado do aplicativo para notificar quando LoadCompleted é manipulado.

Para LoadAsync carregar a entrada XAML de forma assíncrona, o elemento raiz na marcação XAML deve conter o atributo e o valor x:SynchronousMode="Async". O valor é tratado como diferencial de maiúsculas de minúsculas. Se a raiz de marcação XAML não contiver x:SynchronousMode="Async", nenhuma exceção será gerada e a chamada será processada como uma carga síncrona (consulte Load(XmlReader)).

Somente uma operação de carga assíncrona por instância da XamlReader classe pode ser executada por vez. Se mais de uma operação assíncrona for tentada na mesma instância da XamlReader classe, uma InvalidOperationException será gerada.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Load(XmlReader).

Confira também

• 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

Parâmetros

Retornos

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Load(Stream, Boolean).