Partilhar via


PresentationOptions:Atributo Congelar

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

Uso de atributos 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 instancia 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 possa ser designado como ignorable, usando mc:Ignorable Attribute como parte das declarações do elemento raiz. A razão pela qual Freeze deve ser possível ignorar é porque nem todas as implementações de processador XAML são capazes de congelar um Freezable no tempo de carregamento, esse recurso não faz parte da especificação XAML.

A capacidade de processar o Freeze atributo é especificamente incorporada ao 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 WPF XAML ao processar o atributo Freeze nos elementos Freezable durante o carregamento.

Qualquer valor para o atributo Freeze diferente de true (sem diferenciar maiúsculas e minúsculas) gera um erro de tempo de carregamento. (Especificar o Freeze atributo como false não é um erro, mas que já é o padrão, portanto, a configuração para false não faz nada).

Ver também