Compartilhar via


Opções de Apresentação:Atributo Congelar

Define o IsFrozen estado como true no elemento que contém Freezable . O comportamento padrão de um Freezable sem o PresentationOptions:Freeze atributo especificado é que IsFrozen está false em tempo de carga e depende do comportamento geral Freezable durante o tempo de execução.

Uso do atributo XAML

<object
  xmlns:PresentationOptions="http://schemas.microsoft.com/winfx/2006/xaml/presentation/options"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="PresentationOptions">
    <freezableElement PresentationOptions:Freeze="true"/>
</object>

Valores XAML

Valor Descrição
PresentationOptions Um prefixo de namespace XML, que pode ser qualquer cadeia de caracteres de prefixo válida, de acordo com a especificação XML 1.0. O prefixo PresentationOptions é usado para fins de identificação nesta documentação.
freezableElement Um elemento que cria uma instância de qualquer classe derivada de Freezable.

Observações

O Freeze atributo é o único atributo ou outro elemento de programação definido no http://schemas.microsoft.com/winfx/2006/xaml/presentation/options namespace XML. O Freeze atributo existe neste namespace especial especificamente para que ele possa ser designado como ignorável, usando o atributo mc:Ignorable como parte das declarações do elemento raiz. O motivo pelo qual Freeze deve ser capaz de ser ignorado é porque nem todas as implementações de processador XAML são capazes de congelar um Freezable em tempo de carga; essa funcionalidade não faz parte da especificação XAML.

A capacidade de processar o Freeze atributo é especificamente interna no processador XAML que processa XAML para aplicativos compilados. O atributo não é suportado por nenhuma classe e a sintaxe do atributo não é extensível ou modificável. Se você estiver implementando seu próprio processador XAML, poderá optar por replicar o comportamento de congelamento do processador XAML do WPF ao processar o Freeze atributo em Freezable elementos durante o carregamento.

Qualquer valor para o atributo Freeze diferente de true (não diferencia maiúsculas de minúsculas) gera um erro de carregamento. (Especificar o Freeze atributo como false não é um erro, mas esse já é o padrão, portanto, definir para false não fazer nada).

Consulte também