Compartilhar via

<Elemento Application> (.NET Native)

  • Artigo

Serve como um contêiner para tipos em todo o aplicativo e membros de tipo cujos metadados estão disponível para reflexão no runtime e aplica-se à política de reflexão no runtime a todos os elementos de programa em um aplicativo.

<Elemento Directives> Elemento <Application> (rd.xml)

Syntax

<Application Activate="policy_setting"
             Browse="policy_setting"
             Dynamic="policy_setting"
             Serialize="policy_setting"
             DataContractSerializer="policy_setting"
             DataContractJsonSerializer="policy_setting"
             XmlSerializer="policy_setting"
             MarshalObject="policy_setting"
             MarshalDelegate="policy_setting"
             MarshalStructure="policy_setting" />

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai. Na tabela Elementos Filhos, a política refere-se ao tipo de metadados que é disponibilizado para elementos de programa específicos no tempo de execução.

Atributos

Atributo Tipo de atributo Descrição
Activate Reflexão Atributo opcional. Controla o acesso de runtime a construtores para habilitar a ativação de instâncias.
Browse Reflexão Atributo opcional. Controla consultas para obter informações sobre os tipos ou para enumerá-los, mas não permite qualquer acesso dinâmico no tempo de execução.
Dynamic Reflexão Atributo opcional. Controla o acesso a todos os tipos de membro ao runtime, incluindo construtores, métodos, campos, propriedades e eventos, habilitando a programação dinâmica.
Serialize Serialização Atributo opcional. Controla o acesso ao runtime para construtores, campos e propriedades para habilitar a serialização e desserialização das instâncias por bibliotecas como o serializador Newtonsoft JSON.
DataContractSerializer Serialização Atributo opcional. Controla a política de serialização que usa a classe System.Runtime.Serialization.DataContractSerializer.
DataContractJsonSerializer Serialização Atributo opcional. Controla a política de serialização JSON que usa a classe System.Runtime.Serialization.Json.DataContractJsonSerializer.
XmlSerializer Serialização Atributo opcional. Controla a política de serialização XML que usa a classe System.Xml.Serialization.XmlSerializer.
MarshalObject Interoperabilidade Atributo opcional. Política de controles de marshaling de tipos de referência para o Windows Runtime e COM.
MarshalDelegate Interoperabilidade Atributo opcional. Controla a diretiva de marshaling de tipos delegados como ponteiros de função para código nativo.
MarshalStructure Interoperabilidade Atributo opcional. Controla a política de estruturas de marshaling para código nativo.

Todos os atributos

Valor Descrição
policy_setting A configuração para essa política para ser aplicada aos tipos no aplicativo. Os valores possíveis são All, Auto, Excluded, Public, PublicAndInternal, Required Public, Required PublicAndInternal e Required All. Para obter mais informações, consulte Configurações da política da diretiva de runtime.

Elementos filho

Elemento Descrição
<Assembly> Aplica a política a todos os tipos em um assembly específico.
<Namespace> Aplica a política a todos os tipos em um namespace específico.
<Type> Aplica a política a um tipo específico, como uma classe ou estrutura.
<TypeInstantiation> Aplica a política a um tipo genérico construído. Por exemplo, um <elemento TypeInstantiation> pode ser usado para definir a política para um List<String> tipo.
<Método> Aplica a política a um método em um tipo específico.
<MethodInstantiation> Aplica a política a um tipo genérico construído.
<Propriedade> Aplica a política a uma propriedade em um tipo específico.
<Campo> Aplica a política a um campo em um tipo específico.
<Evento> Aplica a política a um evento em um determinado tipo.

Elementos pai

Elemento Descrição
<Diretivas> O elemento raiz de um arquivo de diretivas de runtime.

Comentários

O <elemento Directives> pode conter zero ou um <Application> elemento. Vários elementos <Application> em um mesmo arquivo de diretivas de reflexão não são suportados.

O elemento <Application> pode ser usado em uma de duas formas:

  • Como um contêiner para definir os elementos do programa cujos metadados são necessários no tempo de execução. Nesse caso, o elemento <Application> não precisa ter todos os atributos. No tempo de compilação, as ferramentas do compilador pesquisam todas as bibliotecas, incluindo bibliotecas principais do .NET Framework, buscando elementos do programa identificados por elementos filhos do elemento <Application>. Por outro lado, as ferramentas do compilador pesquisam apenas a biblioteca designada pelo <elemento Library> para elementos de programa identificados pelos elementos filho de <Library>.

  • Como um elemento que define a política de todo o aplicativo para reflexão, serialização e interoperabilidade. Os atributos do elemento definem a <Application> política em todo o aplicativo, que pode ser substituída pelos elementos filho definidos pelo <Application> elemento ou <Library> .

Confira também