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

De meeste kenmerken zijn van toepassing op specifieke taalelementen, zoals klassen of methoden. Sommige kenmerken zijn echter globaal. Ze zijn van toepassing op een hele assembly of module. Gebruik bijvoorbeeld het AssemblyVersionAttribute kenmerk 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. U kunt globale kenmerken opnemen in meerdere bronbestanden, maar u moet de bestanden in één compilatiepas compileren. In .NET Framework-projecten voegt Visual Studio globale kenmerken toe aan het AssemblyInfo.cs-bestand. Deze kenmerken worden niet toegevoegd aan .NET Core-projecten.

De C#-taalreferentiedocumenten de laatst uitgebrachte versie van de C#-taal. Het bevat ook de eerste documentatie voor functies in openbare previews voor de aanstaande taalrelease.

De documentatie identificeert alle functies die voor het eerst zijn geïntroduceerd in de laatste drie versies van de taal of in de huidige openbare previews.

Aanbeveling

Raadpleeg het artikel over de versiegeschiedenis van de C#-taal om te achterhalen wanneer een functie voor het eerst is geïntroduceerd in C#.

Assembly-kenmerken bieden informatie 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. U stelt echter de naamwaarde in door de compiler, de Visual Studio IDE in het dialoogvenster Assembly-gegevens of de Assembly Linker (Al.exe) wanneer u de assembly maakt. 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 een bitsgewijze combinatie van vlaggen voor een assembly op, waarin just-in-time-compileropties (JIT) worden beschreven, of de assembly opnieuw is gericht en of deze een volledige of tokenized openbare sleutel heeft.

Informatieve kenmerken

Gebruik informatieve kenmerken om meer 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

Gebruik de kenmerken van het assemblymanifest 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.