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:
- Sammansättningsidentitetsattribut
- Informationsattribut
- Attribut för sammansättningsmanifest
- Starka namnattribut
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.
Sammansättningsidentitetsattribut
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.
| Attribut för sammansättningsidentitet | 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. Obs! 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. Mer information finns i Så här hittar körningen 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. Obs! Om AssemblyInformationalVersionAttribute attributet inte tillämpas på en sammansättning används versionsnumret som anges av AssemblyVersionAttribute attributet av Application.ProductVersionegenskaperna , Application.UserAppDataPathoch Application.UserAppDataRegistry . |
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")>
Informationsattribut
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 strängen som anges hämtas vid körning med hjälp Application.ProductVersion av egenskapen . Strängen används också i sökvägen och registernyckeln som tillhandahålls av Application.UserAppDataPath egenskaperna 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örningen 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 eget namn när namnet på själva sammansättningen 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 eget namn för sammansättningen. En sammansättning med namnet comdlg kan till exempel ha titeln Microsoft Common Dialog Control. |
Starka namnattribut
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 namnattributen.
| Starkt namnattribut | 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 till 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)>
