Compartilhar via


Atributo x:Class

Configura a compilação da XAML para unir classes parciais entre marcação e código subjacente. A classe parcial do código é definida em um arquivo de código separados em um CLS (Common Language Specification) (CLS) linguagem, enquanto a classe parcial de marcação é criada pela geração de código durante XAML compilação.

Uso de atributos XAML

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

Valores de XAML

namespace

Opcional. Especifica um namespace CLR que contém as classes parciais identificadas por classname. Se namespace é especificado, um ponto (.) separa namespace e classname.

classname

Obrigatório. Especifica o nome CLR da classe parcial que conecta o carregador XAML e seu código subjacente para aquela XAML.

Comentários

x:Class podem ser declaradas como um atributo de qualquer elemento que está na raiz da árvore de elementos Extensible Application Markup Language (XAML) e está sendo compilado (onde o Extensible Application Markup Language (XAML) é incluído em um projeto com a ação de construir Page), ou para a raiz Application na definição da aplicação de uma aplicação compilada. Declarando x:Class em qualquer elemento que não a página raiz ou aplicação raiz, ou em qualquer circunstância para um arquivo Extensible Application Markup Language (XAML) que não é compilado, irá resultar em erro em tempo de compilação.

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

x:Class é opcional no sentido que aquilo é inteiramente legal ter uma página XAML sem nenhum código subjacente, mas se sua página declara valores de atributos de manipulação de eventos, ou instancia elementos personalizados onde as classes definidas são classes no código subjacente, fornecer a referência x:Class (ou x:Subclass) para a classe apropriada para o código subjacente é definitivamente requerido.

O valor do atributo x:Class deve ser uma string que especifica o nome totalmente qualificado de uma classe. Para aplicativos simples, você pode omitir sistema autônomo informações de namespace CLR desde que é sistema autônomo o code-behind é estruturado também (definição inicia no nível de classe). O arquivo de código subjacente para uma página ou definição de aplicação deve ser dentro do arquivo de código que é incluído como parte do projeto que produz a aplicação compilada. Você deve seguir as regras do nome de CLR classes; para obter detalhes, consulte Definições de tipo. Por padrão, a classe de código subjacente deve ser public, mas pode ser definido para ter um diferente nível de acesso usando o x:ClassModifier Attribute.

Note que o significado para o valor do atributo x:Class é específico da implementação do WPF XAML. Outras implementações XAML fora do WPF podem não usar código gerenciado, e então podem usar uma fórmula de resolução de classe diferente.

Consulte também

Conceitos

XAML e classes personalizadas

Code-Behind e XAML

Referência

Atributo x:Subclass

x:ClassModifier Attribute