Compartilhar via


Tipos de dados XAML intrínsecos

O XAML para o Tempo de Execução do Windows fornece suporte em nível de linguagem para vários tipos de dados que são primitivos usados com frequência no CLR (Common Language Runtime) e em outras linguagens de programação, como C++.

O local mais comum em que você verá usos de tipo de dados intrínsecos XAML é quando os recursos são definidos em um dicionário de recursos XAML. Você pode definir constantes lá, por exemplo, números que você usa para vários valores. Ou você pode usar uma animação com storyboard que é animada usando uma cadeia de caracteres ou um valor booliano e, em seguida, precisará de um elemento de objeto XAML que represente a cadeia de caracteres ou booliano para preencher o quadro-chave da definição de ObjectAnimationUsingKeyFrames. Os modelos XAML padrão do Tempo de Execução do Windows usam essas duas técnicas.

O XAML para o Tempo de Execução do Windows fornece suporte no nível da linguagem para esses tipos.

XAML primitivo Descrição
x:Booleano Para suporte a CLR, corresponde a Booleano. O XAML analisa valores para x:Boolean como sem distinção entre maiúsculas e minúsculas. Observe que "x:Bool" não é uma alternativa aceita.
x:Sequência de caracteres Para suporte a CLR, corresponde a String. A codificação da cadeia de caracteres é padronizada para a codificação XML ao redor.
x:Duplo Para suporte a CLR, corresponde a Double. Além dos valores numéricos, a sintaxe de texto para x:Double permite o token "NaN", que é como "Auto" para comportamento de layout pode ser armazenado como um valor de recurso. Os tokens são tratados como diferenciando maiúsculas de minúsculas. Você pode usar notação científica, por exemplo, "1+E06" para 1,000,000.
x:Int32 Para suporte a CLR, corresponde a Int32. x:Int32 é tratado como assinado e você pode incluir o símbolo de menos ("-") para um inteiro negativo. Em XAML, a ausência de uma sintaxe de sinal no texto implica um valor de sinal positivo.

Esses primitivos de linguagem XAML geralmente são os únicos casos em que você define um elemento de objeto que usa o prefixo x: em seu XAML. Todos os outros recursos da linguagem XAML normalmente são usados na forma de atributo ou como uma extensão de marcação.

Observação Por convenção, os primitivos de linguagem para XAML e todos os outros elementos de linguagem XAML são mostrados com o prefixo "x:". É assim que os elementos de linguagem XAML são normalmente usados na marcação do mundo real. Essa convenção é seguida na documentação do XAML e também na especificação XAML.

Outros primitivos XAML

A especificação XAML 2009 observa outros primitivos de nível de linguagem XAML, como x:Uri e x:Single. A menos que listado na tabela deste tópico, outros primitivos de linguagem XAML, conforme definido por outros vocabulários XAML ou pela especificação XAML 2009, não têm suporte no XAML para o Tempo de Execução do Windows.

Observação Datas e horas (propriedades que usam DateTime ou DateTimeOffset, TimeSpan ou System.TimeSpan) não são configuráveis com um primitivo XAML. Essas propriedades geralmente não são configuráveis em XAML, pois não há nenhum comportamento padrão de conversão de cadeia de caracteres no analisador XAML do Tempo de Execução do Windows para datas e horas. Para valores de inicialização de qualquer propriedade de data e hora, você precisará usar code-behind que é executado quando uma página ou elemento é carregado.