AssemblyVersion- en AssemblyFileVersion-kenmerken gebruiken

In dit artikel maakt u kennis met het gebruik AssemblyVersion en AssemblyFileVersion de kenmerken in het AssemblyInfo.cs-bestand.

Oorspronkelijke productversie: .NET Framework
Oorspronkelijk KB-nummer: 556041

Samenvatting

AssemblyInfo.cs biedt twee kenmerken om twee verschillende typen versies in te stellen. Deze tip laat zien hoe u deze twee kenmerken gebruikt.

Microsoft .NET Framework biedt de mogelijkheid om twee verschillende typen versienummers in te stellen op elke assembly.

AssemblyVersion

Dit is het versienummer dat tijdens de build en tijdens runtime door framework wordt gebruikt om de assembly's te vinden, te koppelen en te laden. Wanneer u een verwijzing toevoegt naar een assembly in uw project, is dit versienummer dat wordt ingesloten. Tijdens runtime zoekt Common Language Runtime (CLR) naar assembly met dit versienummer dat moet worden geladen. Maar onthoud dat deze versie wordt gebruikt, samen met naam, openbare-sleuteltoken en cultuurgegevens alleen als de assembly's een sterke naam hebben. Als assembly's niet sterk zijn ondertekend, worden alleen bestandsnamen gebruikt voor het laden.

AssemblyFileVersion

Dit is het versienummer dat aan het bestand wordt gegeven, zoals in het bestandssysteem. Deze wordt weergegeven in Windows Verkenner en wordt nooit gebruikt door .NET Framework of runtime om te verwijzen.

Kenmerken in AssemblyInfo.cs

// Version information for an assembly consists of the following four values:
// Major Version
// Minor Version
// Build Number
// Revision
[assembly: AssemblyVersion("1.0.0.0")]  
[assembly: AssemblyFileVersion("1.0.0.0")]

Als u een (*) opgeeft in plaats van een absoluut getal, verhoogt de compiler het aantal met één telkens wanneer u bouwt.

Stel dat u een frameworkassembly bouwt voor uw project dat door veel ontwikkelaars wordt gebruikt tijdens het bouwen van de toepassingsassembly's. Als u regelmatig een nieuwe versie van assembly vrijgeeft, bijvoorbeeld één keer per dag en als assembly's een sterke naam hebben, moeten ontwikkelaars de verwijzing wijzigen telkens wanneer u een nieuwe assembly vrijgeeft. Het kan lastig zijn en kan ook leiden tot verkeerde verwijzingen. Een betere optie in dergelijke gesloten groep en vluchtige scenario's zou zijn om de AssemblyVersion en alleen de AssemblyFileVersion. Gebruik het versienummer van het assemblybestand om de meest recente versie van assembly te communiceren. In dit geval hoeven ontwikkelaars de verwijzingen niet te wijzigen en kunnen ze de assembly overschrijven in het referentiepad. In centrale of definitieve release-builds is het logischer om de AssemblyVersion assemblyversie te wijzigen en het meest hetzelfde te houden als de AssemblyFileVersion assemblyversie.