Dela via

Ange sammansättningsattribut i kod

Sammansättningsattribut är värden som ger information om en sammansättning. De anges vanligtvis i en AssemblyInfo.cs fil. Attributen är indelade i följande uppsättningar med information:

  • Attribbut för sammansättningsidentitet
  • Informationsattributer
  • Attribut för sammansättningsmanifest
  • De starka namnattributen

Den här artikeln är begränsad till att lägga till sammansättningsattribut från kod. Information om hur du lägger till sammansättningsattribut i projekt (inte i kod) finns i Ange sammansättningsattribut i en projektfil.

Attribbut för sammansättningsidentitet

Tre attribut, tillsammans med ett starkt namn (om tillämpligt), bestämmer identiteten för en sammansättning: namn, version och kultur. Dessa attribut utgör det fullständiga namnet på sammansättningen och krävs när du refererar till sammansättningen i koden. Du kan använda attribut för att ange en sammansättnings version och kultur. Kompilatorn eller Assembly Linker (Al.exe) anger namnvärdet när sammansättningen skapas, baserat på filen som innehåller sammansättningsmanifestet.

I följande tabell beskrivs attributen version och kultur.

Sammansättningsidentitetsattribut Beskrivning
AssemblyCultureAttribute Uppräknat fält som anger den kultur som sammansättningen stöder. En sammansättning kan också ange kulturberoende, vilket anger att den innehåller resurserna för standardkulturen. Not: Körningen behandlar alla sammansättningar som inte har kulturattributet inställt på null som en satellitsammansättning. Sådana sammansättningar omfattas av bindande regler för satellitsammansättning. För mer information, se Hur runtime hittar sammansättningar.
AssemblyFlagsAttribute Värde som anger sammansättningsattribut, till exempel om sammansättningen kan köras sida vid sida.
AssemblyVersionAttribute Numeriskt värde i formatet major. mindre. bygge. revision (till exempel 2.4.0.0). Common Language Runtime använder det här värdet för att utföra bindningsåtgärder i starka namngivna sammansättningar. Observera: Om AssemblyInformationalVersionAttribute attributet inte tillämpas på en sammansättning, används versionsnumret som anges av AssemblyVersionAttribute attributet av Application.ProductVersion, Application.UserAppDataPath och Application.UserAppDataRegistry egenskaperna.

I följande kodexempel visas hur du tillämpar versions- och kulturattributen på en sammansättning.

// 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")>

Informationsattributer

Du kan använda informationsattribut för att tillhandahålla ytterligare företagsinformation eller produktinformation för en sammansättning. I följande tabell beskrivs de informationsattribut som du kan använda för en sammansättning.

Informationsattribut Beskrivning
AssemblyCompanyAttribute Strängvärde som anger ett företagsnamn.
AssemblyCopyrightAttribute Strängvärde som anger upphovsrättsinformation.
AssemblyFileVersionAttribute Strängvärde som anger versionsnumret för Win32-filen. Detta är vanligtvis standardinställningen för sammansättningsversionen.
AssemblyInformationalVersionAttribute Strängvärde som anger versionsinformation som inte används av den vanliga språkkörningen, till exempel ett fullständigt produktversionsnummer. Obs: Om det här attributet tillämpas på en sammansättning kan den sträng som den anger hämtas under körning med hjälp av Application.ProductVersion-egenskapen. Strängen används också i sökvägen och registernyckeln som tillhandahålls av egenskaperna Application.UserAppDataPath och Application.UserAppDataRegistry.
AssemblyProductAttribute Strängvärde som anger produktinformation.
AssemblyTrademarkAttribute Strängvärde som anger varumärkesinformation.

Dessa attribut kan visas på sidan Windows-egenskaper i sammansättningen, eller så kan de åsidosättas med hjälp av kompileringsalternativet /win32res för att ange din Win32-resursfil.

Attribut för sammansättningsmanifest

Du kan använda attribut för sammansättningsmanifestet för att ange information i sammansättningsmanifestet, inklusive rubrik, beskrivning, standardalias och konfiguration. I följande tabell beskrivs attributen för sammansättningsmanifestet.

Attribut för sammansättningsmanifest Beskrivning
AssemblyConfigurationAttribute Strängvärde som anger konfigurationen av sammansättningen, till exempel Detaljhandel eller Felsökning. Körtiden använder inte det här värdet.
AssemblyDefaultAliasAttribute Strängvärde som anger ett standardalias som ska användas genom att referera till sammansättningar. Det här värdet ger ett vänligare namn när namnet på själva assemblyn inte är användarvänligt (till exempel ett GUID-värde). Det här värdet kan också användas som en kort form av det fullständiga sammansättningsnamnet.
AssemblyDescriptionAttribute Strängvärde som anger en kort beskrivning som sammanfattar sammansättningens natur och syfte.
AssemblyTitleAttribute Strängvärde som anger ett vänligt namn för sammansättningen. En sammansättning med namnet comdlg kan till exempel ha titeln Microsoft Common Dialog Control.

De starka namnattributen

Du kan använda starka namnattribut för att ange ett starkt namn för en sammansättning. I följande tabell beskrivs de starka namnegenskaperna.

Starkt namnatribut Beskrivning
AssemblyDelaySignAttribute Booleskt värde som anger att fördröjningssignering används.
AssemblyKeyFileAttribute Strängvärde som anger namnet på filen som innehåller antingen den offentliga nyckeln (om du använder fördröjningssignering) eller både de offentliga och privata nycklarna som skickas som en parameter till konstruktorn för det här attributet. Observera att filnamnet är relativt sökvägen till utdatafilen ( .exe eller .dll), inte källfilens sökväg.
AssemblyKeyNameAttribute Anger nyckelcontainern som innehåller nyckelparet som skickas som en parameter till konstruktorn för det här attributet.

I följande kodexempel visas de attribut som ska tillämpas när du använder fördröjningssignering för att skapa en stark namngiven sammansättning med en offentlig nyckelfil med namnet myKey.snk.

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

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

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

Se även