Attribut på sammansättningsnivå som tolkas av C#-kompilatorn

De flesta attribut gäller för specifika språkelement, till exempel klasser eller metoder. Vissa attribut är dock globala. De gäller för en hel sammansättning eller modul. Använd till exempel AssemblyVersionAttribute attributet för att bädda in versionsinformation i en sammansättning, så här:

[assembly: AssemblyVersion("1.0.0.0")]

Globala attribut visas i källkoden efter alla toppnivådirektiv using och före alla typ-, modul- eller namnområdesdeklarationer. Du kan inkludera globala attribut i flera källfiler, men du måste kompilera filerna i ett enda kompileringspass. I .NET Framework-projekt lägger Visual Studio till globala attribut i filen AssemblyInfo.cs. Dessa attribut läggs inte till i .NET Core-projekt.

C#-språkreferensen dokumenterar den senaste versionen av C#-språket. Den innehåller även inledande dokumentation för funktioner i offentliga förhandsversioner för den kommande språkversionen.

Dokumentationen identifierar alla funktioner som först introducerades i de tre senaste versionerna av språket eller i aktuella offentliga förhandsversioner.

Tips/Råd

Information om när en funktion först introducerades i C# finns i artikeln om språkversionshistoriken för C#.

Sammansättningsattribut ger information om en sammansättning. De är indelade i följande kategorier:

• Sammansättningsidentitetsattribut
• Informationsattribut
• Attribut för sammansättningsmanifest

Sammansättningsidentitetsattribut

Tre attribut (med ett starkt namn, om tillämpligt) avgör 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 den i kod. Du kan ange en sammansättnings version och kultur med hjälp av attribut. Du anger dock namnvärdet av kompilatorn, Visual Studio IDE i dialogrutan Sammansättningsinformation eller Assembly Linker (Al.exe) när du skapar sammansättningen. Sammansättningsnamnet baseras på sammansättningsmanifestet. Attributet AssemblyFlagsAttribute anger om flera kopior av sammansättningen kan samexistera.

I följande tabell visas identitetsattributen.

Attribut	Syfte
AssemblyVersionAttribute	Anger versionen av en sammansättning.
AssemblyCultureAttribute	Anger vilken kultur sammansättningen stöder.
AssemblyFlagsAttribute	Anger en bitvis kombination av flaggor för en sammansättning, som beskriver jit-kompilatoralternativ (just-in-time), om sammansättningen kan återanvändas och om den har en fullständig eller tokeniserad offentlig nyckel.

Informationsattribut

Använd informationsattribut för att tillhandahålla mer företagsinformation eller produktinformation för en sammansättning. I följande tabell visas de informationsattribut som definierats i System.Reflection namnområdet.

Attribut	Syfte
AssemblyProductAttribute	Anger ett produktnamn för ett sammansättningsmanifest.
AssemblyTrademarkAttribute	Anger ett varumärke för ett sammansättningsmanifest.
AssemblyInformationalVersionAttribute	Anger en informationsversion för ett sammansättningsmanifest.
AssemblyCompanyAttribute	Anger ett företagsnamn för ett sammansättningsmanifest.
AssemblyCopyrightAttribute	Definierar ett anpassat attribut som anger en upphovsrätt för ett sammansättningsmanifest.
AssemblyFileVersionAttribute	Anger ett specifikt versionsnummer för Win32-filversionsresursen.
CLSCompliantAttribute	Anger om sammansättningen är kompatibel med COMMON Language Specification (CLS).

Attribut för sammansättningsmanifest

Använd attribut för sammansättningsmanifest för att ange information i sammansättningsmanifestet. Attributen omfattar rubrik, beskrivning, standardalias och konfiguration. I följande tabell visas de sammansättningsmanifestattribut som definierats i System.Reflection namnområdet.

Attribut	Syfte
AssemblyTitleAttribute	Anger en sammansättningstitel för ett sammansättningsmanifest.
AssemblyDescriptionAttribute	Anger en sammansättningsbeskrivning för ett sammansättningsmanifest.
AssemblyConfigurationAttribute	Anger en sammansättningskonfiguration (till exempel detaljhandel eller felsökning) för ett sammansättningsmanifest.
AssemblyDefaultAliasAttribute	Definierar ett eget standardalias för ett sammansättningsmanifest.