Partilhar via

Atributo x:Load

  • Artigo

Você pode usar x:Load para otimizar a inicialização, a criação da árvore visual e o uso de memória do seu aplicativo XAML. O uso de x:Load tem um efeito visual semelhante ao Visibility, exceto que, quando o elemento não é carregado, sua memória é liberada e, internamente, um pequeno espaço reservado é usado para marcar seu lugar na árvore visual.

O elemento de interface do usuário atribuído com x:Load pode ser carregado e descarregado por meio de código ou usando uma expressão x:Bind . Isso é útil para reduzir os custos de elementos que são mostrados de forma pouco frequente ou condicional. Quando você usa x:Load em um contêiner como Grid ou StackPanel, o contêiner e todos os seus filhos são carregados ou descarregados como um grupo.

O controle de elementos adiados pela estrutura XAML adiciona cerca de 600 bytes ao uso de memória para cada elemento atribuído com x:Load, para considerar o espaço reservado. Portanto, é possível abusar desse atributo na medida em que seu desempenho realmente diminui. Recomendamos que você o use apenas em elementos que precisam ser ocultados. Se você usar x:Load em um contêiner, a sobrecarga será paga apenas pelo elemento com o atributo x:Load.

Importante

O atributo x:Load está disponível a partir do Windows 10, versão 1703 (Atualização para Criadores). A versão mínima de destino do seu projeto Visual Studio deve ser a Atualização do Windows 10 para Criadores (10.0, build 15063) para usar x:Load.

Uso do atributo XAML

<object x:Load="True" .../>
<object x:Load="False" .../>
<object x:Load="{x:Bind Path.to.a.boolean, Mode=OneWay}" .../>

Elementos de carregamento

Existem várias maneiras diferentes de carregar os elementos:

  • Use uma expressão x:Bind para especificar o estado de carregamento. A expressão deve retornar true para carregar e false para descarregar o elemento.
  • Chame FindName com o nome definido no elemento.
  • Chame GetTemplateChild com o nome definido no elemento.
  • Em um VisualState, use uma animação Setter ou Storyboard direcionada ao elemento x:Load.
  • Direcione o elemento descarregado em qualquer Storyboard.

OBSERVAÇÃO: Depois que a instanciação de um elemento for iniciada, ele será criado no thread da interface do usuário, de maneira que faça a interface do usuário ser dividida se várias forem criadas de uma só vez.

Depois que um elemento adiado for criado por um dos métodos listados acima, várias coisas acontecerão:

  • O evento Loaded no elemento será acionado.
  • O campo para x:Name está definido.
  • Todas as associações x:Bind no elemento são aplicadas.
  • Se o aplicativo tiver se registrado para receber notificações de alteração feita na propriedade sobre a propriedade que contém os elementos adiados, a notificação será acionada.

Elementos de descarga

Para descarregar um elemento:

  • Use uma expressão x:Bind para especificar o estado de carregamento. A expressão deve retornar true para carregar e false para descarregar o elemento.
  • Em um Page ou UserControl, chame UnloadObject e passe a referência de objeto
  • Chame Windows.UI.Xaml.Markup.XamlMarkupHelper.UnloadObject e passe a referência de objeto

Quando um objeto é descarregado, ele será substituído na árvore por um espaço reservado. A instância do objeto permanecerá na memória até que todas as referências tenham sido liberadas. A API UnloadObject em um Page/UserControl foi projetada para liberar as referências mantidas pelo codegen para x:Name e x:Bind. Se você tiver referências adicionais no código do aplicativo, elas também precisarão ser liberadas.

Quando um elemento é descarregado, todo o estado associado ao elemento será descartado, portanto, se estiver usando x:Load como uma versão otimizada de Visibility, verifique se todo o estado é aplicado por meio de associações ou é reaplicado pelo código quando o evento Loaded for disparado.

Restrições

As restrições para usar x:Load são:

  • Você deve definir um X:Names para o elemento, uma vez que deve haver uma forma de encontrar o elemento depois.
  • Você só pode usar x:Load em tipos derivados de UIElement ou FlyoutBase.
  • Você não pode usar x:Load em elementos raiz em uma Page, um UserControl ou um DataTemplate.
  • Você não pode usar x:Load em elementos em um ResourceDictionary.
  • Você não pode usar x:Load em XAML solto carregado com XamlReader.Load.
  • Mover um elemento pai limpará todos os elementos que não foram carregados.

Comentários

Você pode usar x:Load em elementos aninhados, no entanto, eles precisam ser realizados a partir do elemento mais externo para dentro.  Se você tentar observar um elemento filho antes que o pai tenha sido percebido, uma exceção será gerada.

Normalmente, recomendamos que você adie elementos que não são visíveis no primeiro quadro. Uma boa orientação para encontrar os candidatos a serem diferidos é procurar elementos que estão sendo criados com Visibilidade recolhida. Além disso, a UI que é desencadeada pela interação do usuário é um bom lugar para procurar elementos que você pode adiar.

Seja cauteloso ao adiar elementos em um ListView, pois o tempo de inicialização será menor, mas também o desempenho do movimento panorâmico pode ser reduzido, dependendo do que você está criando. Se você estiver procurando melhorar o desempenho de movimento panorâmico, consulte a documentação sobre extensão de marcação {x: Bind} e atributo x:Phase.

Se o atributo x:Phase for usado em conjunto com x:Load , quando um elemento ou uma árvore de elementos for realizado, as associações serão aplicadas até e incluindo a fase atual. A fase especificada para x:Phase afeta ou controla o estado de carregamento do elemento. Quando um item de lista é reciclado como parte do movimento panorâmico, os elementos realizados se comportam da mesma maneira que outros elementos ativos e as associações compiladas (associações {x:Bind} ) são processadas usando as mesmas regras, incluindo fases.

Uma diretriz geral é avaliar o desempenho do aplicativo antes e depois, para garantir que você obtenha o desempenho que deseja.

Para minimizar as alterações no comportamento (além do desempenho) ao adicionar x:Load a um elemento, as associações x:Bind são calculadas em seus horários normais, como se nenhum elemento usasse x:Load. Por exemplo, as associações x:Bind do OneTime são calculadas quando o elemento raiz é carregado. Se o elemento não for realizado no momento em que a associação x:Bind for calculada, o valor calculado será salvo e aplicado ao elemento quando ele for carregado. Esse comportamento pode ser surpreendente se você esperava que as associações x:Bind fossem calculadas quando o elemento é realizado.

Exemplo

<StackPanel>
    <Grid x:Name="DeferredGrid" x:Load="False">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto" />
            <RowDefinition Height="Auto" />
        </Grid.RowDefinitions>
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="Auto" />
            <ColumnDefinition Width="Auto" />
        </Grid.ColumnDefinitions>

        <Rectangle Height="100" Width="100" Fill="Orange" Margin="0,0,4,4"/>
        <Rectangle Height="100" Width="100" Fill="Green" Grid.Column="1" Margin="4,0,0,4"/>
        <Rectangle Height="100" Width="100" Fill="Blue" Grid.Row="1" Margin="0,4,4,0"/>
        <Rectangle Height="100" Width="100" Fill="Gold" Grid.Row="1" Grid.Column="1" Margin="4,4,0,0"
                   x:Name="one" x:Load="{x:Bind (x:Boolean)CheckBox1.IsChecked, Mode=OneWay}"/>
        <Rectangle Height="100" Width="100" Fill="Silver" Grid.Row="1" Grid.Column="1" Margin="4,4,0,0"
                   x:Name="two" x:Load="{x:Bind Not(CheckBox1.IsChecked), Mode=OneWay}"/>
    </Grid>

    <Button Content="Load elements" Click="LoadElements_Click"/>
    <Button Content="Unload elements" Click="UnloadElements_Click"/>
    <CheckBox x:Name="CheckBox1" Content="Swap Elements" />
</StackPanel>

// This is used by the bindings between the rectangles and check box.
private bool Not(bool? value) { return !(value==true); }

private void LoadElements_Click(object sender, RoutedEventArgs e)
{
    // This will load the deferred grid, but not the nested
    // rectangles that have x:Load attributes.
    this.FindName("DeferredGrid"); 
}

private void UnloadElements_Click(object sender, RoutedEventArgs e)
{
     // This will unload the grid and all its child elements.
     this.UnloadObject(DeferredGrid);
}