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

A legtöbb attribútum bizonyos nyelvi elemekre, például osztályokra vagy metódusokra vonatkozik. Egyes attribútumok azonban globálisak. Ezek egy teljes szerelvényre vagy modulra vonatkoznak. Az attribútum használatával AssemblyVersionAttribute például beágyazhat verzióinformációkat egy szerelvénybe, 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útumokat több forrásfájlba is felveheti, de a fájlokat egyetlen fordítási menetben kell lefordítania. A .NET-keretrendszer projektjeiben a Visual Studio globális attribútumokat ad hozzá a AssemblyInfo.cs fájlhoz. Ezek az attribútumok nem lesznek hozzáadva a .NET Core-projektekhez.

A C# nyelv referenciadokumentuma a C# nyelv legújabb kiadású verzióját ismerteti. Emellett a közelgő nyelvi kiadás nyilvános előzetes verziójú funkcióinak kezdeti dokumentációját is tartalmazza.

A dokumentáció azonosítja azokat a funkciókat, amelyeket először a nyelv utolsó három verziójában vagy az aktuális nyilvános előzetes verziókban vezetnek be.

Jótanács

Ha meg szeretné tudni, hogy mikor jelent meg először egy funkció a C#-ban, tekintse meg a C# nyelvi verzióelőzményeiről szóló cikket.

A szerelvény attribútumai 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útumok használatával állíthatja be. A szerelvény létrehozásakor azonban beállítja a névértéket a fordító, a Visual Studio IDE a Szerelvényinformációk párbeszédpanelen, vagy a szerelvény-összecsatoló (Al.exe). 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

Szerelvényjegyzék-attribútumok használatával adja meg az adatokat 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 aliast definiál egy szerelvényjegyzékhez.