共用方式為

<Library> 項目 (.NET Native)

  • 發行項

定義包含類型和類型成員的組件，這些類型和類型成員的中繼資料可在執行階段用於反映。

<Directives> 項目 <Library> 項目

語法

<Library Name="assembly_name" />

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

屬性 描述
Name 必要屬性。 指定組件的名稱。 這個 <Library> 項目的子項目可針對這個組件中找到的類型和類型成員，定義其執行階段反映原則。

Name 屬性

值 Description
assembly_name 組件的簡單名稱，不包含其副檔名。 這個屬性 (Attribute) 會對應至 AssemblyName.Name 屬性 (Property)。 例如，名為 Extensions.dll 之組件的名稱是 "Extensions"。 如需支援從組件條件式包含中繼資料之 assembly_name 的特殊格式，請參閱＜備註＞一節。

子元素

元素 描述
<組件> 將原則套用至特定組件中的所有類型。
<Namespace> 將原則套用至特定命名空間中的所有類型。
<類型> 將原則套用至特定類型，例如類別或結構。
<TypeInstantiation> 將原則套用至建構的泛型類型。 例如，<TypeInstantiation> 項目可用來定義 List<String> 類型的原則。

父項目

元素 描述
<指示詞> 執行階段指示詞檔案的根項目。

備註

<Directives> 項目可包含零、一或多個 <Library> 項目。

<Library> 項目可當做容器來使用，以定義在執行階段需要中繼資料的程式項目；這個項目不會表示原則。 在編譯時期，編譯器工具只會在 <Library> 項目所指定的程式庫中，搜尋其子項目所識別的程式項目。 在其他情況下，編譯器工具會在所有程式庫 (包含 .NET Framework 核心程式庫) 中，搜尋 <Application> 項目的子項目所識別的程式項目。

您可以有條件地利用 <Library> 指示詞。 如果 <Library> 項目的名稱以星號 (*) 開始和結尾，則只有在應用程式參考星號之間指定的組件時，<Library> 指示詞才會生效。 例如，只有在應用程式參考 Utilities.dll 組件時，下列執行階段指示詞才適用。

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

另請參閱