Assemblykenmerken instellen in code

  • Artikel

Assemblykenmerken zijn waarden die informatie geven over een assembly. Ze worden meestal ingesteld in een AssemblyInfo.cs-bestand . De kenmerken zijn onderverdeeld in de volgende gegevenssets:

  • Assembly-identiteitskenmerken
  • Informatieve kenmerken
  • Assemblymanifestkenmerken
  • Sterke naamkenmerken

Dit artikel is bedoeld voor het toevoegen van assemblykenmerken uit code. Zie Assembly-kenmerken instellen in een projectbestand voor informatie over het toevoegen van assemblykenmerken aan projecten (niet in code).

Assembly-identiteitskenmerken

Drie kenmerken, samen 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 bij het verwijzen naar de assembly in code. U kunt kenmerken gebruiken om de versie en cultuur van een assembly in te stellen. De compiler of assembly linker (Al.exe) stelt de naamwaarde in wanneer de assembly wordt gemaakt, op basis van het bestand dat het assemblymanifest bevat.

In de volgende tabel worden de versie- en cultuurkenmerken beschreven.

Kenmerk Assembly-identiteit Beschrijving
AssemblyCultureAttribute Geïnventariseerd veld dat de cultuur aangeeft die door de assembly wordt ondersteund. Een assembly kan ook de onafhankelijkheid van de cultuur opgeven, wat aangeeft dat deze de resources voor de standaardcultuur bevat. Opmerking: De runtime behandelt alle assembly's waarvoor het cultuurkenmerk niet is ingesteld op null als een satellietassembly. Dergelijke assembly's zijn onderworpen aan bindingsregels voor satellietassembly's. Zie Hoe de runtime assembly's zoekt voor meer informatie.
AssemblyFlagsAttribute Waarde waarmee assemblykenmerken worden ingesteld, bijvoorbeeld of de assembly naast elkaar kan worden uitgevoerd.
AssemblyVersionAttribute Numerieke waarde in de primaire notatie.minor.build.revisie (bijvoorbeeld 2.4.0.0). De algemene taalruntime gebruikt deze waarde om bindingsbewerkingen uit te voeren in sterk benoemde assembly's. Opmerking: Als het AssemblyInformationalVersionAttribute kenmerk niet wordt toegepast op een assembly, wordt het versienummer dat is opgegeven door het AssemblyVersionAttribute kenmerk gebruikt door de Application.ProductVersion, Application.UserAppDataPathen Application.UserAppDataRegistry eigenschappen.

In het volgende codevoorbeeld ziet u hoe u de versie- en cultuurkenmerken toepast op een assembly.

// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")];
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")];

// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")]
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")]

' Set version number for the assembly.
<Assembly:AssemblyVersionAttribute("4.3.2.1")>
' Set culture as German.
<Assembly:AssemblyCultureAttribute("de")>

Informatieve kenmerken

U kunt informatieve kenmerken gebruiken om aanvullende bedrijfs- of productgegevens voor een assembly op te geven. In de volgende tabel worden de informatieve kenmerken beschreven die u op een assembly kunt toepassen.

Informatiekenmerk Beschrijving
AssemblyCompanyAttribute Tekenreekswaarde die een bedrijfsnaam opgeeft.
AssemblyCopyrightAttribute Tekenreekswaarde die copyrightgegevens opgeeft.
AssemblyFileVersionAttribute Tekenreekswaarde die het versienummer van het Win32-bestand opgeeft. Dit wordt normaal gesproken standaard ingesteld op de assemblyversie.
AssemblyInformationalVersionAttribute Tekenreekswaarde die versie-informatie opgeeft die niet wordt gebruikt door de algemene taalruntime, zoals een volledig productversienummer. Opmerking: Als dit kenmerk wordt toegepast op een assembly, kan de tekenreeks die wordt opgegeven tijdens runtime worden verkregen met behulp van de Application.ProductVersion eigenschap. De tekenreeks wordt ook gebruikt in het pad en de registersleutel die wordt geleverd door de Application.UserAppDataPath en Application.UserAppDataRegistry eigenschappen.
AssemblyProductAttribute Tekenreekswaarde die productgegevens opgeeft.
AssemblyTrademarkAttribute Tekenreekswaarde die handelsmerkgegevens opgeeft.

Deze kenmerken kunnen worden weergegeven op de pagina Windows-eigenschappen van de assembly of ze kunnen worden overschreven met behulp van de optie /win32res compiler om uw Win32-resourcebestand op te geven.

Assemblymanifestkenmerken

U kunt assemblymanifestkenmerken gebruiken om informatie op te geven in het assemblymanifest, inclusief titel, beschrijving, de standaardalias en configuratie. In de volgende tabel worden de kenmerken van het assemblymanifest beschreven.

Kenmerk Assembly-manifest Beschrijving
AssemblyConfigurationAttribute Tekenreekswaarde die de configuratie van de assembly aangeeft, zoals Retail of Debug. De runtime gebruikt deze waarde niet.
AssemblyDefaultAliasAttribute Tekenreekswaarde die een standaardalias opgeeft die moet worden gebruikt door te verwijzen naar assembly's. Deze waarde biedt een beschrijvende naam wanneer de naam van de assembly zelf niet vriendelijk is (zoals een GUID-waarde). Deze waarde kan ook worden gebruikt als een korte vorm van de volledige assemblynaam.
AssemblyDescriptionAttribute Tekenreekswaarde die een korte beschrijving aangeeft waarin de aard en het doel van de assembly worden samengevat.
AssemblyTitleAttribute Tekenreekswaarde die een beschrijvende naam voor de assembly opgeeft. Een assembly met de naam comdlg kan bijvoorbeeld de titel Microsoft Common Dialog Control hebben.

Sterke naamkenmerken

U kunt sterke naamkenmerken gebruiken om een sterke naam in te stellen voor een assembly. In de volgende tabel worden de sterke naamkenmerken beschreven.

Sterk naamkenmerk Beschrijving
AssemblyDelaySignAttribute Booleaanse waarde die aangeeft dat vertragingsondertekening wordt gebruikt.
AssemblyKeyFileAttribute Tekenreekswaarde die de naam aangeeft van het bestand dat de openbare sleutel bevat (als u vertragingsondertekening gebruikt) of zowel de openbare als de persoonlijke sleutels die als parameter zijn doorgegeven aan de constructor van dit kenmerk. Houd er rekening mee dat de bestandsnaam relatief is ten opzichte van het pad naar het uitvoerbestand (de .exe of .dll), niet het pad naar het bronbestand.
AssemblyKeyNameAttribute Geeft de sleutelcontainer aan die het sleutelpaar bevat dat als parameter is doorgegeven aan de constructor van dit kenmerk.

In het volgende codevoorbeeld ziet u de kenmerken die moeten worden toegepast bij het gebruik van vertraging bij het maken van een sterk benoemde assembly met een openbare-sleutelbestand met de naam myKey.snk.

[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];

[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]

<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>

Zie ook