Compartilhar via

<Elemento Library> (.NET Native)

  • Artigo

Define o assembly que contém tipos e membros de tipo cujos metadados estão disponíveis para reflexão em tempo de execução.

<Elemento Directives> Element <Library>

Syntax

<Library Name="assembly_name" />

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
Name Atributo obrigatório. Especifica o nome de um assembly. Elementos filhos deste elemento <Library> define a política de reflexão do runtime para tipos e membros de tipo encontrados neste assembly.

Atributo de nome

Valor Descrição
assembly_name O nome simples do assembly, sem a extensão de arquivo. Este atributo corresponde à propriedade AssemblyName.Name . Por exemplo, o nome de um assembly denominado Extensions.dll é "Extensions". Consulte a seção Comentários para ver uma forma especial de assembly_name que dá suporte à inclusão condicional de metadados do assembly.

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.

Elementos pai

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

Comentários

O <elemento Directives> pode conter zero, um ou mais <Library> elementos.

O elemento <Library> serve como um contêiner para definir os elementos do programa cujos metadados são necessária no tempo de execução. Este elemento não expressa política. No tempo de compilação, as ferramentas do compilador pesquisam somente a biblioteca designada pelo elemento <Library> para os elementos do programa identificados por seus elementos filho. Por outro lado, as ferramentas do compilador pesquisam todas as bibliotecas, including.NET bibliotecas principais do Framework, para elementos de programa identificados por elementos filho do <elemento Application> .

As diretivas <Library> podem ser utilizadas condicionalmente. Se o nome do <Library> elemento for iniciado e terminar com um asterisco (*), a <Library> diretiva terá um efeito somente se o assembly especificado entre os asteriscos for referenciado pelo aplicativo. Por exemplo, a diretiva de runtime a seguir se aplicará somente se o assembly Utilities.dll for referenciado pelo aplicativo.

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Library Name="*Utilities*">
   ...
  </Library>
</Directives>

Confira também