Freigeben über

Assemblymanifest

Jede Assembly, ob statisch oder dynamisch, enthält eine Sammlung von Daten, die beschreibt, wie die Elemente in der Assembly miteinander zusammenhängen. Das Assemblymanifest enthält diese Assemblymetadaten. Ein Assemblymanifest enthält alle Metadaten, die zum Angeben der Versionsanforderungen und der Sicherheitsidentität der Assembly erforderlich sind, sowie alle Metadaten, die zum Definieren des Umfangs der Assembly erforderlich sind, und zum Auflösen von Verweisen auf Ressourcen und Klassen. Das Assemblymanifest kann entweder in einer PE-Datei (einem .exe oder .dll) mit common Intermediate Language (CIL)-Code oder in einer eigenständigen PE-Datei gespeichert werden, die nur Assemblymanifestinformationen enthält.

Die folgende Abbildung zeigt die verschiedenen Möglichkeiten, wie das Manifest gespeichert werden kann.

Diagramm des Manifests in der Konfiguration einer Einzeldateiassembly und einer Mehrfachdateiassembly

Bei einer Assembly mit einer zugeordneten Datei wird das Manifest in die PE-Datei integriert, um eine Einzeldateiassembly zu bilden. Sie können eine Multifileassembly mit einer eigenständigen Manifestdatei oder mit dem Manifest erstellen, das in eine der PE-Dateien in der Assembly integriert ist.

Das Manifest jeder Assembly führt die folgenden Funktionen aus:

  • Listet die Dateien auf, aus denen die Assembly besteht.

  • Steuert, wie Verweise auf die Typen und Ressourcen der Assembly den Dateien zugeordnet werden, die ihre Deklarationen und Implementierungen enthalten.

  • Auflisten anderer Assemblys, von denen die Assembly abhängig ist.

  • Bereitstellen einer Dereferenzierungsebene zwischen den Consumern der Assembly und den Implementierungsdetails der Assembly.

  • Wiedergabe der Selbstbeschreibung der Assembly.

Inhalte des Assembly-Manifests

In der folgenden Tabelle sind die Informationen im Assemblymanifest aufgeführt. Die Identität einer Assembly setzt sich aus den ersten vier Elementen zusammen. Dabei handelt es sich um den Assemblynamen, die Versionsnummer, die Kultur und den starken Namen.

Informationen BESCHREIBUNG
Assemblyname Eine Zeichenfolge, die den Namen der Assembly angibt.
Versionsnummer Eine Haupt- und Nebenversionsnummer und eine Revisions- und Buildnummer. Die Common Language Runtime verwendet diese Nummern zum Erzwingen der Versionsrichtlinie.
Kultur Informationen zur Kultur oder Sprache, die die Assembly unterstützt. Diese Informationen sollten nur verwendet werden, um eine Assembly als Satellitenassembly mit kultur- oder sprachspezifischen Informationen zu benennen. (Eine Assembly mit Kulturinformationen wird automatisch als Satellitenassembly betrachtet.)
Informationen über den starken Namen Der öffentliche Schlüssel des Herausgebers, falls der Assembly ein starker Name zugewiesen wurde.
Liste aller Dateien in der Assembly Ein Hash jeder Datei, die in der Assembly enthalten ist, und einen Dateinamen. Beachten Sie, dass sich alle Dateien, aus denen die Assembly besteht, im selben Verzeichnis wie die Datei mit dem Assemblymanifest befinden muss.
Typverweisinformationen Informationen, mit denen die Common Language Runtime einen Typverweis auf die Datei zuordnet, die ihre Deklaration und Implementierung enthält. Dies wird für Typen verwendet, die aus der Assembly exportiert werden.
Informationen über Assemblys, auf die verwiesen wird Eine Liste mit anderen Assemblys, auf die statische Verweise in der Assembly vorhanden sind. Ein Verweis umfasst den Namen der abhängigen Assembly, die Assemblymetadaten (Version, Kultur, Betriebssystem usw.) und den öffentlichen Schlüssel, wenn die Assembly einen starken Namen besitzt.

Sie können einige Informationen im Assemblymanifest hinzufügen oder ändern, indem Sie Assemblyattribute in Ihrem Code verwenden. Sie können Versionsinformationen und Informationsattribute ändern, einschließlich Marken, Copyright, Produkt, Unternehmen und InformationalVersion. Eine vollständige Liste der Assemblyattribute finden Sie unter "Festlegen von Assemblyattributen".

Siehe auch

  • Last updated on