<Elemento Library> (.NET Native)

  • Articolo

Definisce l'assembly che contiene i tipi e i membri dei tipi i cui metadati sono disponibili per la reflection al runtime.

<Elemento Library> degli <elementi> Directive

Sintassi

<Library Name="assembly_name" />

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
Name Attributo obbligatorio. Specifica il nome di un assembly. Gli elementi figlio di questo elemento <Library> definiscono i criteri di reflection di runtime per i tipi e i membri dei tipi rilevati nell'assembly.

Name (attributo)

Valore Descrizione
assembly_name Il nome semplice dell'assembly, senza estensione di file. Questo attributo corrisponde alla proprietà AssemblyName.Name. Ad esempio, il nome di un assembly denominato Extensions.dll è "Extensions". Vedere la sezione Note per informazioni su un formato speciale di assembly_name che supporta l'inclusione condizionale di metadati dall'assembly.

Elementi figlio

Elemento Descrizione
<Assemblaggio> Applica i criteri a tutti i tipi in un determinato assembly.
<Spazio dei nomi> Applica i criteri a tutti i tipi in un determinato spazio dei nomi.
<Type> Applica i criteri a un determinato tipo, ad esempio una classe o una struttura.
<TypeInstantiation> Applica i criteri a un tipo generico costruito. Ad esempio, un elemento <TypeInstantiation> può essere usato per definire i criteri per un tipo List<String> .

Elementi padre

Elemento Descrizione
<Direttive> L'elemento radice di un file di direttive di runtime.

Osservazioni:

L'elemento <Directives> può contenere nessuno, uno o più <Library> elementi.

L'elemento <Library> viene usato come contenitore per definire gli elementi di programma i cui metadati sono richiesti al runtime; questo elemento non esprime criteri. Durante la compilazione, gli strumenti di compilazione cercano gli elementi di programma identificati dagli elementi figlio solo nella libreria designata dall'elemento <Library>. Al contrario, gli strumenti di compilazione cercano gli elementi di programma identificati dagli elementi figlio dell'elemento <Application> in tutte le librerie, incluse le librerie di base .NET Framework.

Le direttive <Library> possono essere usate in modo condizionale. Se il nome dell'elemento <Library> inizia e termina con un asterisco (*), la direttiva <Library> ha effetto solo se l'assembly specificato tra gli asterischi fa riferimento all'app. Ad esempio, la direttiva di runtime seguente si applica solo se l'assembly Utilities.dll fa riferimento all'app.

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

Vedi anche