Partilhar via


Tipos de dados intrínsecos XAML

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 freqüência no Common Language Runtime (CLR) e em outras linguagens de programação, como C++.

O local mais comum em que você verá usos de tipos 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 pode-se utilizar uma animação em storyboard que anima usando uma cadeia de caracteres ou um valor booleano e, em seguida, precisará de um elemento de objeto XAML que represente a cadeia de caracteres ou o valor booleano para preencher o quadro-chave da sua definição 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 em nível de idioma para esses tipos.

Primitiva XAML Description
x:Boolean Para suporte CLR, corresponde a Booleano. O XAML analisa valores para x:Boolean como insensível a maiúsculas e minúsculas. Note que "x:Bool" não é uma alternativa aceite.
x:Cadeia de caracteres Para suporte CLR, corresponde a String. A codificação da cadeia de caracteres assume como padrão a codificação XML ao redor.
x:Double Para suporte CLR, corresponde a Double. Além dos valores numéricos, a sintaxe de texto para x:Double permite o uso do token "NaN", que é a forma como "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 notação científica, por exemplo, "1+E06" para 1,000,000.
x:Int32 Para suporte CLR, corresponde a Int32. x:Int32 é tratado como assinado, e pode-se incluir o símbolo menos ("-") para um inteiro negativo. Em XAML, a ausência de um sinal na sintaxe do texto implica um valor assinado positivo.

Essas primitivas 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 são normalmente usados em 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 da linguagem XAML são normalmente usados na marcação do mundo real. Essa convenção é seguida na documentação para XAML e também na especificação XAML.

Outras primitivas XAML

A especificação XAML 2009 observa outras primitivas de nível de linguagem XAML, como x:Uri e x:Single. A menos que listadas na tabela deste tópico, outras primitivas de linguagem XAML, conforme definidas por outros vocabulários XAML ou pela especificação XAML 2009, não são suportadas atualmente em 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 uma primitiva XAML. Essas propriedades geralmente não podem ser definidas em XAML, porque não há um comportamento padrão de conversão de cadeia de caracteres para datas e horas no analisador XAML do Windows Runtime. Para os valores de inicialização de quaisquer propriedades de data e hora, terá de usar código de fundo que é executado quando uma página ou elemento é carregado.