Sammansättningsmanifest

Varje sammansättning, oavsett om den är statisk eller dynamisk, innehåller en samling data som beskriver hur elementen i sammansättningen relaterar till varandra. Sammansättningsmanifestet innehåller dessa sammansättningsmetadata. Ett sammansättningsmanifest innehåller alla metadata som behövs för att ange sammansättningens versionskrav och säkerhetsidentitet och alla metadata som behövs för att definiera sammansättningsomfånget och matcha referenser till resurser och klasser. Sammansättningsmanifestet kan lagras i antingen en PE-fil (en .exe eller .dll) med CIL-kod (Common Intermediate Language) eller i en fristående PE-fil som endast innehåller information om sammansättningsmanifestet.

Följande bild visar de olika sätt som manifestet kan lagras på.

För en sammansättning med en associerad fil införlivas manifestet i PE-filen för att bilda en sammansättning med en enda fil. Du kan skapa en sammansättning med flera filer med en fristående manifestfil eller med manifestet som ingår i en av PE-filerna i sammansättningen.

Varje sammansättnings manifest utför följande funktioner:

• Räknar upp de filer som utgör sammansättningen.

• Styr hur referenser till sammansättningens typer och resurser mappas till de filer som innehåller deras deklarationer och implementeringar.

• Räknar upp andra sammansättningar som sammansättningen är beroende av.

• Tillhandahåller en nivå av indirektion mellan användare av sammansättningen och sammansättningens implementeringsinformation.

• Återger sammansättningen självbeskrivande.

Sammansättningsmanifestinnehåll

Följande tabell visar informationen i sammansättningsmanifestet. De första fyra objekten: sammansättningsnamn, versionsnummer, kultur och stark namninformation utgör sammansättningens identitet.

Information	beskrivning
Sammansättningsnamn	En textsträng som anger sammansättningens namn.
Versionsnummer	Ett huvud- och delversionsnummer samt ett revisions- och versionsnummer. Den vanliga språkkörningen använder dessa nummer för att framtvinga versionsprincip.
Kultur	Information om kulturen eller språket som sammansättningen stöder. Den här informationen bör endast användas för att utse en sammansättning som en satellitsammansättning som innehåller kultur- eller språkspecifik information. (En sammansättning med kulturinformation antas automatiskt vara en satellitsammansättning.)
Stark namninformation	Den offentliga nyckeln från utgivaren om sammansättningen har fått ett starkt namn.
Lista över alla filer i sammansättningen	En hash för varje fil som ingår i sammansättningen och ett filnamn. Observera att alla filer som utgör sammansättningen måste finnas i samma katalog som filen som innehåller sammansättningsmanifestet.
Ange referensinformation	Information som används av körningen för att mappa en typreferens till filen som innehåller dess deklaration och implementering. Detta används för typer som exporteras från sammansättningen.
Information om refererade sammansättningar	En lista över andra sammansättningar som statiskt refereras till av sammansättningen. Varje referens innehåller den beroende sammansättningens namn, sammansättningsmetadata (version, kultur, operativsystem och så vidare) och offentlig nyckel, om sammansättningen är stark med namnet.

Du kan lägga till eller ändra viss information i sammansättningsmanifestet med hjälp av sammansättningsattribut i koden. Du kan ändra versionsinformation och informationsattribut, inklusive varumärkes-, upphovsrätts-, produkt-, företags- och informationsversion. En fullständig lista över sammansättningsattribut finns i Ange sammansättningsattribut.

Se även

• Sammansättningsinnehåll
• Versionshantering för sammansättning
• Skapa satellitsammansättningar
• Starka namngivna sammansättningar