定義包含類型和類型成員的組件，這些類型和類型成員的中繼資料可在執行階段用於反映。
<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>