Compartilhar via

Diretiva x:FieldModifier

  • Artigo

Modifica o comportamento da compilação XAML para que os campos para referências de objeto nomeado sejam definidos com acesso TypeAttributes.Public em vez do comportamento padrão TypeAttributes.NotPublic.

Uso do atributo XAML

<object x:FieldModifier="Public".../>

Valores XAML

Valor Descrição
public A cadeia de caracteres exata que você passa para especificar TypeAttributes.Public versus TypeAttributes.NotPublic varia, dependendo da linguagem de programação code-behind usada. Consulte Comentários.

Dependências

Se uma produção XAML usar em qualquer lugar, o elemento raiz dessa produção XAML deverá declarar umde diretiva x:Class .

Observações

x:FieldModifier não é relevante para declarar o nível de acesso geral de uma classe ou de seus membros. Ela é relevante apenas para o comportamento de processamento XAML quando um objeto XAML específico que faz parte de uma produção XAML é processado e se torna um objeto potencialmente acessível no grafo de objeto de um aplicativo. Por padrão, a referência de campo para esse objeto é mantida privada, o que impede que os consumidores de controle modifiquem o grafo de objeto diretamente. Em vez disso, espera-se que os consumidores de controle modifiquem o grafo de objeto usando padrões habilitados por modelos de programação, como obtendo a raiz de layout, as coleções de elementos filho, as propriedades públicas dedicadas e assim por diante.

O valor do atributo x:FieldModifier varia de acordo com a linguagem de programação e sua finalidade pode variar em estruturas específicas. A cadeia de caracteres a ser usada depende de como cada idioma implementa seu CodeDomProvider e dos conversores de tipo que retorna para definir os significados para TypeAttributes.Public e TypeAttributes.NotPublice se essa linguagem diferencia maiúsculas de minúsculas.

  • Para C#, a cadeia de caracteres a ser passada para designar TypeAttributes.Public é public.

  • Para o .NET do Microsoft Visual Basic, a cadeia de caracteres a ser passada para designar TypeAttributes.Public é Public.

  • Para C++/CLI, não existem destinos para XAML no momento; portanto, a cadeia de caracteres a ser passada é indefinida.

Você também pode especificar TypeAttributes.NotPublic (internal em C#, Friend no Visual Basic), mas especificar TypeAttributes.NotPublic é incomum porque NotPublic como o comportamento já é o padrão.

TypeAttributes.NotPublic é o comportamento padrão porque não é frequente que o código fora do assembly que compilou o XAML precise de acesso a um elemento criado por XAML. A arquitetura de segurança do WPF, juntamente com o comportamento de compilação XAML, não declarará campos que armazenam instâncias de elemento como públicas, a menos que você defina especificamente o x:FieldModifier para permitir o acesso público.

x:FieldModifier só é relevante para elementos com uma diretiva x:Name porque esse nome é usado para referenciar o campo depois que ele é público.

Por padrão, a classe parcial do elemento raiz é pública; no entanto, você pode torná-lo não público usando a diretiva x:ClassModifier. A diretiva x:ClassModifier também afeta o nível de acesso da instância da classe de elemento raiz. Você pode colocar x:Name e x:FieldModifier no elemento raiz, mas isso só faz uma cópia de campo público do elemento raiz, com o nível de acesso da classe de elemento raiz verdadeiro ainda controlado por diretiva x:ClassModifier.

Consulte também