Dela via

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

  • Artikel

De flesta attribut tillämpas på specifika språkelement, till exempel klasser eller metoder. Vissa attribut är dock globala – de gäller för en hel sammansättning eller modul. Attributet kan till exempel AssemblyVersionAttribute användas 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. Globala attribut kan visas i flera källfiler, men filerna måste kompileras i ett enda kompileringspass. Visual Studio lägger till globala attribut till filen AssemblyInfo.cs i .NET Framework-projekt. Dessa attribut läggs inte till i .NET Core-projekt.

Sammansättningsattribut är värden som 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. Namnvärdet anges dock av kompilatorn, Visual Studio IDE i dialogrutan Sammansättningsinformation eller Assembly Linker (Al.exe) när sammansättningen skapas. 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

Du använder informationsattribut för att ange 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

Du kan använda attribut för sammansättningsmanifestet 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