A C# fordító által értelmezett szerelvényszintű attribútumok

A legtöbb attribútum adott nyelvi elemekre, például osztályokra vagy metódusokra van alkalmazva; egyes attribútumok azonban globálisak – egy teljes szerelvényre vagy modulra vonatkoznak. Az attribútum például a AssemblyVersionAttribute verzióinformációk szerelvénybe való beágyazására használható, például a következőhöz:

[assembly: AssemblyVersion("1.0.0.0")]

A globális attribútumok a forráskódban jelennek meg a legfelső szintű using irányelvek után, illetve bármilyen típus-, modul- vagy névtérdeklaráció előtt. A globális attribútumok több forrásfájlban is megjelenhetnek, de a fájlokat egyetlen fordítási menetben kell lefordítani. A Visual Studio globális attribútumokat ad hozzá a AssemblyInfo.cs fájlhoz .NET-keretrendszer projektekben. Ezek az attribútumok nem lesznek hozzáadva a .NET Core-projektekhez.

A szerelvényattribútumok olyan értékek, amelyek információt nyújtanak egy szerelvényről. Ezek a következő kategóriákba sorolhatók:

• Szerelvényidentitás-attribútumok
• Információs attribútumok
• Szerelvényjegyzék attribútumai

Szerelvényidentitás-attribútumok

A szerelvény identitását három attribútum határozza meg (adott esetben erős névvel): név, verzió és kultúra. Ezek az attribútumok alkotják a szerelvény teljes nevét, és a kódban való hivatkozáshoz szükségesek. A szerelvény verzióját és kultúráját attribútumokkal állíthatja be. A névértéket azonban a fordító, a Visual Studio IDE a Szerelvényinformációk párbeszédpanelen vagy a szerelvény-összecsatoló (Al.exe) állítja be a szerelvény létrehozásakor. A szerelvény neve a szerelvényjegyzéken alapul. Az AssemblyFlagsAttribute attribútum azt határozza meg, hogy a szerelvény több példánya is létezhet-e.

Az alábbi táblázat az identitásattribútumokat mutatja be.

Attribútum	Cél
AssemblyVersionAttribute	Egy szerelvény verzióját adja meg.
AssemblyCultureAttribute	Meghatározza, hogy a szerelvény mely kultúrát támogatja.
AssemblyFlagsAttribute	A szerelvény jelzőinek bitenkénti kombinációját adja meg, amely leírja az igény szerinti (JIT) fordító beállításait, azt, hogy a szerelvény újratározható-e, és hogy rendelkezik-e teljes vagy jogkivonatos nyilvános kulccsal.

Információs attribútumok

Az információs attribútumokkal több céges vagy termékinformációt adhat meg egy szerelvényhez. Az alábbi táblázat a névtérben System.Reflection definiált információs attribútumokat mutatja be.

Attribútum	Cél
AssemblyProductAttribute	Egy szerelvényjegyzék terméknevét adja meg.
AssemblyTrademarkAttribute	Egy szerelvényjegyzék védjegyét adja meg.
AssemblyInformationalVersionAttribute	A szerelvényjegyzék információs verzióját adja meg.
AssemblyCompanyAttribute	Egy szerelvényjegyzék cégnevét adja meg.
AssemblyCopyrightAttribute	Olyan egyéni attribútumot határoz meg, amely szerzői jogot határoz meg egy szerelvényjegyzékhez.
AssemblyFileVersionAttribute	Beállít egy adott verziószámot a Win32 fájlverzió-erőforráshoz.
CLSCompliantAttribute	Azt jelzi, hogy a szerelvény megfelel-e a Common Language Specification (CLS) szabványnak.

Szerelvényjegyzék attribútumai

A szerelvényjegyzék attribútumai segítségével információkat adhat meg a szerelvényjegyzékben. Az attribútumok közé tartozik a cím, a leírás, az alapértelmezett alias és a konfiguráció. Az alábbi táblázat a névtérben definiált szerelvényjegyzék-attribútumokat System.Reflection mutatja be.

Attribútum	Cél
AssemblyTitleAttribute	Szerelvényjegyzék szerelvénycímét adja meg.
AssemblyDescriptionAttribute	Egy szerelvényjegyzék szerelvényleírását adja meg.
AssemblyConfigurationAttribute	Szerelvénykonfigurációt (például kiskereskedelmi vagy hibakeresési) ad meg egy szerelvényjegyzékhez.
AssemblyDefaultAliasAttribute	Rövid alapértelmezett alias definiálása egy szerelvényjegyzékhez