Compartilhar via

Tipos de dados XAML intrínsecos

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

O lugar 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 anima usando uma string ou valor booleano e, em seguida, precisará de um objeto XAML que represente a string ou o valor booleano para preencher o quadro-chave da definição ObjectAnimationUsingKeyFrames. Os modelos XAML padrão do Windows Runtime usam essas duas técnicas.

O XAML para o Windows Runtime fornece suporte em nível de linguagem para esses tipos.

Primitivo XAML Description
x:Boolean Para suporte ao CLR, corresponde ao Booleano. XAML analisa valores para x:Boolean como não sensíveis a maiúsculas e minúsculas. Observe que "x:Bool" não é uma alternativa aceita.
x:String Para suporte a CLR, corresponde a String. A codificação da cadeia de caracteres é padrão para a codificação XML ao redor.
x:Double Para suporte ao CLR, corresponde ao Double. Além dos valores numéricos, a sintaxe de texto para x:Double permite o token "NaN", o que indica que "Auto" para o comportamento de layout pode ser armazenado como um valor de recurso. Os tokens são tratados como sensíveis a maiúsculas e minúsculas. Você pode usar a notação científica, por exemplo, "1+E06" para 1,000,000.
x:Int32 Para suporte a CLR, corresponde ao Int32. x:Int32 é tratado como assinado, sendo que você pode incluir o sinal de menos ("-") para um inteiro negativo. No XAML, a ausência de um sinal na sintaxe do texto implica um valor com 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 de linguagem XAML normalmente são usados no formulário 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 da linguagem XAML são mostrados com o prefixo "x:". É assim que os elementos da linguagem XAML normalmente são 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 no nível da linguagem XAML, como x:Uri e x:Single. A menos que listados na tabela neste 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 atualmente no XAML para o Windows Runtime.

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 Windows Runtime para datas e horas. Para valores de inicialização de quaisquer propriedades de data e hora, você precisará usar code-behind, que é executado quando uma página ou elemento é carregado.

  • Last updated on