Udostępnij za pośrednictwem

Manifest modułu

Każdy zestaw, niezależnie od tego, czy jest statyczny, czy dynamiczny, zawiera kolekcję danych, która opisuje, jak elementy w zestawie odnoszą się do siebie nawzajem. Manifest zestawu zawiera te metadane zestawu. Manifest zestawu zawiera wszystkie metadane potrzebne do określenia wymagań dotyczących wersji zestawu i tożsamości zabezpieczeń oraz wszystkie metadane potrzebne do zdefiniowania zakresu zestawu i rozpoznawania odwołań do zasobów i klas. Manifest zestawu może być przechowywany w pliku PE ( .exe lub .dll) z kodem wspólnego języka pośredniego (CIL) lub w autonomicznym pliku PE, który zawiera tylko informacje o manifeście zestawu.

Na poniższej ilustracji przedstawiono różne sposoby przechowywania manifestu.

Diagram przedstawiający manifest w konfiguracji zestawu jednoplikowego i zestawu wieloplikowego.

W przypadku zestawu zawierającego jeden powiązany plik, manifest jest włączany do pliku PE, tworząc zestaw jednoplikowy. Zestaw wieloplikowy można utworzyć z autonomicznym plikiem manifestu lub manifestem dołączonym do jednego z plików PE w zestawie.

Manifest każdego zestawu wykonuje następujące funkcje:

  • Wylicza pliki tworzące zestaw.

  • Reguluje sposób, w jaki odwołania do typów i zasobów zestawu są mapowane do plików zawierających ich deklaracje i implementacje.

  • Wylicza inne zestawy, od których zależy zestaw.

  • Zapewnia poziom pośredni między konsumentami zestawu a szczegółami implementacji zestawu.

  • Renderuje zestaw samoopisujący.

Zawartość manifestu zestawu

Poniższa tabela pokazuje informacje zawarte w manifeście zestawu. Pierwsze cztery elementy: nazwa zestawu, numer wersji, kultura i informacje o silnej nazwie składają się na tożsamość zestawu.

Informacja Opis
Nazwa zestawu Ciąg tekstowy określający nazwę zestawu.
Numer wersji Numer wersji głównej i podrzędnej, numer rewizji i numer kompilacji. Środowisko uruchomieniowe języka wspólnego używa tych liczb do wymuszania zasad wersji.
Kultura Informacje na temat kultury lub języka obsługiwanego przez zestaw. Te informacje powinny służyć tylko do wyznaczenia zestawu jako zestawu satelitarnego zawierającego informacje specyficzne dla kultury lub języka. (Zestaw z informacjami o kulturze jest automatycznie zakładany jako zestaw satelitarny).
Informacje o silnej nazwie Klucz publiczny od wydawcy, jeśli zestaw otrzymał silną nazwę.
Lista wszystkich plików w zestawie Skrót każdego pliku zawartego w zestawie a nazwa pliku. Należy pamiętać, że wszystkie pliki tworzące zestaw muszą znajdować się w tym samym katalogu co plik zawierający manifest zestawu.
Informacje referencyjne o typie Informacje używane przez środowisko uruchomieniowe do mapowania odwołania typu do pliku zawierającego jego deklarację i implementację. Jest to używane w przypadku typów eksportowanych z zestawu.
Informacje na temat zestawów, do których się odwołujesz Lista innych zestawów, które są statycznie referencowane przez dany zestaw. Każde odwołanie zawiera nazwę zestawu zależnego, metadane zestawu (wersja, kultura, system operacyjny itd.) i klucz publiczny, jeśli zestaw ma silną nazwę.

Niektóre informacje w manifeście zestawu można dodawać lub zmieniać, używając atrybutów zestawu w kodzie. Można zmienić informacje o wersji i atrybuty informacyjne, w tym znaki towarowe, prawa autorskie, produkt, firmę i wersję informacyjną. Aby uzyskać pełną listę atrybutów zestawu, zobacz Ustawianie atrybutów zestawu.

Zobacz także