Kenmerken op assemblyniveau geïnterpreteerd door de C#-compiler

De meeste kenmerken worden toegepast op specifieke taalelementen, zoals klassen of methoden; Sommige kenmerken zijn echter globaal, ze zijn van toepassing op een volledige assembly of module. Het kenmerk kan bijvoorbeeld AssemblyVersionAttribute worden gebruikt om versiegegevens in te sluiten in een assembly, zoals deze:

[assembly: AssemblyVersion("1.0.0.0")]

Globale kenmerken worden weergegeven in de broncode na instructies op het hoogste niveau using en vóór elk type, module of naamruimtedeclaraties. Globale kenmerken kunnen worden weergegeven in meerdere bronbestanden, maar de bestanden moeten worden gecompileerd in één compilatiepas. Visual Studio voegt globale kenmerken toe aan het AssemblyInfo.cs-bestand in .NET Framework-projecten. Deze kenmerken worden niet toegevoegd aan .NET Core-projecten.

Assemblykenmerken zijn waarden die informatie geven over een assembly. Ze vallen in de volgende categorieën:

• Assembly-identiteitskenmerken
• Informatieve kenmerken
• Assemblymanifestkenmerken

Assembly-identiteitskenmerken

Drie kenmerken (met een sterke naam, indien van toepassing) bepalen de identiteit van een assembly: naam, versie en cultuur. Deze kenmerken vormen de volledige naam van de assembly en zijn vereist wanneer u ernaar verwijst in code. U kunt de versie en cultuur van een assembly instellen met behulp van kenmerken. De naamwaarde wordt echter ingesteld door de compiler, de Visual Studio IDE in het dialoogvenster Assembly-informatie of de Assembly Linker (Al.exe) wanneer de assembly wordt gemaakt. De assemblynaam is gebaseerd op het assemblymanifest. Het AssemblyFlagsAttribute kenmerk geeft aan of meerdere exemplaren van de assembly naast elkaar kunnen bestaan.

In de volgende tabel ziet u de identiteitskenmerken.

Kenmerk	Doel
AssemblyVersionAttribute	Hiermee geeft u de versie van een assembly.
AssemblyCultureAttribute	Hiermee geeft u op welke cultuur de assembly ondersteunt.
AssemblyFlagsAttribute	Hiermee geeft u op of een assembly ondersteuning biedt voor uitvoering naast elkaar op dezelfde computer, in hetzelfde proces of in hetzelfde toepassingsdomein.

Informatieve kenmerken

U gebruikt informatieve kenmerken om aanvullende bedrijfs- of productgegevens voor een assembly op te geven. In de volgende tabel ziet u de informatieve kenmerken die zijn gedefinieerd in de System.Reflection naamruimte.

Kenmerk	Doel
AssemblyProductAttribute	Hiermee geeft u een productnaam voor een assemblymanifest.
AssemblyTrademarkAttribute	Hiermee geeft u een handelsmerk voor een assemblymanifest.
AssemblyInformationalVersionAttribute	Hiermee geeft u een informatieve versie voor een assemblymanifest.
AssemblyCompanyAttribute	Hiermee geeft u een bedrijfsnaam voor een assemblymanifest.
AssemblyCopyrightAttribute	Hiermee definieert u een aangepast kenmerk dat een copyright voor een assemblymanifest aangeeft.
AssemblyFileVersionAttribute	Hiermee stelt u een specifiek versienummer in voor de Win32-bestandsversieresource.
CLSCompliantAttribute	Geeft aan of de assembly voldoet aan de Common Language Specification (CLS).

Assemblymanifestkenmerken

U kunt de kenmerken van het assemblymanifest gebruiken om informatie op te geven in het assemblymanifest. De kenmerken omvatten titel, beschrijving, standaardalias en configuratie. In de volgende tabel ziet u de kenmerken van het assemblymanifest die zijn gedefinieerd in de System.Reflection naamruimte.

Kenmerk	Doel
AssemblyTitleAttribute	Hiermee geeft u een assemblytitel voor een assemblymanifest op.
AssemblyDescriptionAttribute	Hiermee geeft u een assemblybeschrijving voor een assemblymanifest.
AssemblyConfigurationAttribute	Hiermee geeft u een assemblyconfiguratie (zoals detailhandel of foutopsporing) op voor een assemblymanifest.
AssemblyDefaultAliasAttribute	Definieert een beschrijvende standaardalias voor een assemblymanifest