Partilhar via


x:Atributo de classe

Configura a compilação XAML para unir as classes parciais entre o XAML e o código associado. A classe parcial de código é definida em um arquivo de código separado e a classe parcial de marcação é criada pela geração de código durante a compilação XAML.

Uso de atributos XAML

<object x:Class="namespace.classname"...>
  ...
</object>

Valores XAML

Term Description
espaço de nomes Opcional. Especifica um namespace que contém a classe parcial identificada por classname. Se namespace for especificado, um ponto (.) separa namespace e classname. Se o namespace for omitido, presume-se que classname não tenha namespace.
Nome da classe Required. Especifica o nome da classe parcial que conecta o XAML carregado e o código subjacente para esse XAML.

Observações

x:Class pode ser declarado como um atributo para qualquer elemento que seja a raiz de uma árvore de arquivo/objeto XAML e esteja sendo compilado por ações de compilação, ou para a raiz Application na definição de aplicativo de um aplicativo compilado. Declarar x:Class em qualquer elemento que não seja um nó raiz, e em quaisquer circunstâncias para um ficheiro XAML que não esteja a ser compilado com a Page build action, resulta num erro em tempo de compilação.

A classe usada como x:Class não pode ser uma classe aninhada.

O valor do atributo x:Class deve ser uma cadeia de caracteres que especifica o nome totalmente qualificado de uma classe. Você pode omitir informações de namespace, desde que o code-behind esteja estruturado da mesma forma (a sua definição de classe começa no nível da classe). O arquivo code-behind para uma definição de página ou aplicativo deve estar dentro de um arquivo de código incluído como parte do projeto. A classe code-behind deve ser pública. A classe code-behind deve ser parcial.

Regras de linguagem CLR

Embora seu arquivo code-behind possa ser um arquivo C++, há certas convenções que ainda seguem o formulário de linguagem CLR, para que não haja diferença na sintaxe XAML. Em particular, o separador entre os componentes namespace e classname de qualquer valor x:Class é sempre um ponto ("."), mesmo que o separador entre namespace e classname no arquivo de código C++ associado ao XAML seja "::". Se você declarar namespaces aninhados em C++, o separador entre as cadeias de caracteres de namespace aninhadas sucessivas também deverá ser "." em vez de "::" quando você especificar a parte do namespace do valor x:Class .