Diretiva X:Class
Configura a compilação da marcação XAML para ingressar em classes parciais entre marcação e code-behind. A classe parcial do código é definida em um arquivo de código separados em um Common Language Specification (CLS) o idioma, enquanto a classe parcial de marcação é normalmente criada pela geração do código durante a compilação de XAML.
XAML Attribute Usage
<object x:Class="namespace.classname"...>
...
</object>
XAML Values
namespace |
Optional. Specifies a CLR namespace that contains the partial class identified by classname. Se namespace for especificado, um ponto (.) separa namespace e classname. Consulte comentários. |
classname |
Required. Especifica o CLR nome da classe parcial que conecta o XAML carregado e o code-behind para XAML. |
Dependencies
x:Classsó pode ser especificado no elemento raiz de uma produção de XAML. x:Classnão é válido em qualquer objeto que tem um pai na produção de XAML. Para obter mais informações, consulte [MS-XAML] seção 4.3.1.6.
Comentários
Oo valor de namespace pode conter pontos adicionais para organizar os namespaces relacionados em hierarquias de nome, que é uma técnica comum no.NET Framework programação. O último ponto em uma seqüência de x:Class valores é interpretada para separar namespace e classname. A classe que é usada como x:Class não pode ser uma classe de aninhados. Classes aninhadas não são permitidos como determinar o significado de pontos de x:Class seqüências de caracteres é ambíguo se classes aninhadas são permitidos.
No existentes modelos de programação que usam x:Class, x:Class é opcional no sentido de que ela é totalmente válida para ter uma página XAML que não tem código-behind. No entanto, esse recurso interage com as ações de construção conforme implementado por estruturas de XAML. x:Classrecurso também é influenciado pelas funções que várias classificações de conteúdo especificado em XAML tem um modelo de aplicativo e ações de construção no correspondente. Se seu XAML declara os valores de atributo de manipulação de eventos ou instancia elementos personalizados, onde as classes de definição estão na classe code-behind, você deve fornecer o x:Class referência de diretiva (ou X:Subclass) para a classe apropriada para o code-behind.
O valor da x:Class diretiva deve ser uma seqüência de caracteres que especifica o nome totalmente qualificado de uma classe, mas sem qualquer informação de assembly (equivalente a Type.FullName). Para aplicativos simples, você pode omitir informações de namespace CLR se code-behind também é estruturado dessa maneira (definição do código inicia no nível de classe).
O arquivo de code-behind para uma definição de aplicativo ou página deve estar dentro de um arquivo de código é incluído como parte do projeto que produz um aplicativo compilado e envolve a compilação da marcação. Você deve seguir as regras de nome para classes CLR. For more information, see Diretrizes de Design para desenvolvimento bibliotecas de classe. Por padrão, a classe code-behind deve ser public; No entanto, você pode defini-la em um nível de acesso diferente usando o Diretiva de x: ClassModifier.
Essa interpretação do x:Class atributo se aplica somente a uma implementação de XAML baseado em CLR, em particular para.NET Framework XAML Services. Outras implementações de XAML que não são baseados em CLR e que não usam.NET Framework XAML Services pode usar uma fórmula de resolução diferente para conectar a marcação XAML e fazendo o código de tempo de execução. Para obter mais informações sobre interpretações mais gerais de x:Class, consulte [MS-xaml].
Em um determinado nível da arquitetura, o significado de x:Class não está definida no.NET Framework XAML Services. Isso ocorre porque.NET Framework XAML Services não especifica o modelo de programação pelo qual XAML marcação e fazendo o código estão conectados. Usos adicionais de x:Class diretiva pode ser implementada por estruturas específicas, usam os modelos de aplicativo ou modelos de programação para definir como conectar-se a marcação XAML e código baseado em CLR-behind. Cada estrutura pode ter suas próprias ações de compilação que permitem que alguns dos componentes específicos que devem ser incluídos no ambiente de compilação ou comportamento. Dentro de uma estrutura, ações de compilação também podem variar dependendo da linguagem específica do CLR que é usada para o code-behind.
x: classe no modelo de programação do WPF
Em aplicativos WPF e o modelo de aplicativo do WPF, x:Class pode ser declarado como um atributo para qualquer elemento que é a raiz de um arquivo XAML e está sendo compilado (onde o XAML está incluído em um projeto de aplicativo do WPF com Page Criar ação), ou para o Application raiz na definição de aplicativo de um aplicativo WPF compilado. Declarando x:Class em um elemento diferente, por exemplo, uma raiz de página ou a raiz do aplicativo ou em um arquivo de WPF XAML não é compilado, causa um erro em tempo de compilação sob o .NET Framework 3.0 e .NET Framework 3.5 compilador de WPF XAML. Para obter informações sobre outros aspectos do x:Class manipulação no WPF, consulte Code-Behind e XAML no WPF.
X:Class for Windows Workflow Foundation
Para o Windows Workflow Foundation, x:Class a classe de uma atividade personalizada composta inteiramente em XAML ou nomes de classe parcial da página XAML para um designer de atividade com o código-behind.
Notas de uso do Silverlight
x:Classpara o Silverlight é documentado separadamente. Para obter mais informações, consulte Namespace XAML (x:) Recursos de linguagem (Silverlight).
Consulte também
Referência
Conceitos
Classes de personalizadas para WPF e XAML