Nyelv

Szerelvényattribútumok beállítása a kódban

A szerelvényattribútumok olyan értékek, amelyek információt nyújtanak egy szerelvényről. Ezek általában egy AssemblyInfo.cs fájlban vannak beállítva. Az attribútumok a következő információkészletekre vannak osztva:

  • Szerelvényidentitás-attribútumok
  • Információs attribútumok
  • Összeállítási jegyzék attribútumai
  • Erős névattribútumok

Ez a cikk az összeszerelési attribútumok kódból történő hozzáadására vonatkozik. További információ a szerelvényattribútumok projektekhez való hozzáadásáról (nem kódban), lásd: Szerelvényattribútumok beállítása egy projektfájlban.

Szerelvényidentitás-attribútumok

Három attribútum, valamint egy erős név (ha alkalmazható) határozza meg egy assembly identitását: név, verzió és kultúra. Ezek az attribútumok alkotják a szerelvény teljes nevét, és a kódban a szerelvényre való hivatkozáshoz szükségesek. Attribútumokkal beállíthatja egy szerelvény verzióját és kultúráját. A fordító vagy a Assembly Linker (Al.exe) a szerelvény létrehozásakor a szerelvényjegyzéket tartalmazó fájl alapján állítja be a névértéket.

Az alábbi táblázat a verzió- és kulturális attribútumokat ismerteti.

Szerelvényidentitás-attribútum Leírás
AssemblyCultureAttribute Enumerált mező, amely az összeállítás által támogatott kultúrát jelzi. A gyülekezet a kulturális függetlenséget is meghatározhatja, jelezve, hogy erőforrásokat tartalmaz az általános és az alapértelmezett kultúrához. Jegyzet: A futtatókörnyezet minden olyan szerelvényt kezel, amely nem rendelkezik null értékű kulturális attribútummal műholdas szerelvényként. Az ilyen szerelvényekre a műholdas szerelvényekre vonatkozó kötési szabályok vonatkoznak. További információ: Hogyan találja meg a futtatókörnyezet a szerelvényeket.
AssemblyFlagsAttribute Szerelvényattribútumokat állító érték, például hogy a szerelvény futtatható-e egymás mellett.
AssemblyVersionAttribute Numerikus érték a főverzió.alverzió.buildelem.revízió formátumban (például 2.4.0.0). A közös nyelvi futtatókörnyezet ezt az értéket használja a kötési műveletek erős névvel ellátott szerelvényekben való végrehajtásához. Jegyzet: Ha az AssemblyInformationalVersionAttribute attribútum nincs alkalmazva egy szerelvényre, az AssemblyVersionAttribute attribútum által megadott verziószámot használja az , Application.ProductVersionés Application.UserAppDataPath a Application.UserAppDataRegistrytulajdonságok.

Az alábbi példakód bemutatja, hogyan alkalmazhatja a verzió- és kulturális attribútumokat egy szerelvényre.

// 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")>

Információs attribútumok

Az információs attribútumokkal további vállalati vagy termékinformációkat adhat meg egy szerelvényhez. Az alábbi táblázat azokat az információs attribútumokat ismerteti, amelyeket egy szerelvényre alkalmazhat.

Információs attribútum Leírás
AssemblyCompanyAttribute Egy vállalat nevét meghatározó karakterlánc érték.
AssemblyCopyrightAttribute A szerzői jogi adatokat meghatározó karakterláncérték.
AssemblyFileVersionAttribute A Win32-fájl verziószámát meghatározó sztringérték. Ez általában az összeállítás verziójának alapértelmezett értéke.
AssemblyInformationalVersionAttribute Sztringérték, amely a közös nyelvi futtatókörnyezet által nem használt verzióadatokat adja meg, például egy teljes termékverzió számát. Jegyzet: Ha ezt az attribútumot egy szerelvényre alkalmazza, az általa megadott sztring futásidőben lekérhető a Application.ProductVersion tulajdonság használatával. A sztringet a Application.UserAppDataPath és Application.UserAppDataRegistry tulajdonságok által megadott elérési úton és beállításkulcsban is használja a rendszer.
AssemblyProductAttribute Termékinformációkat meghatározó sztringérték.
AssemblyTrademarkAttribute Sztringérték, amely a védjegyinformációkat adja meg.

Ezek az attribútumok megjelenhetnek a szerelvény Windows Tulajdonságok lapján, vagy felül lehet őket bírálni a /win32res fordítóval a Win32-erőforrásfájl megadásához.

Összeállítási jegyzék attribútumai

A szerelvényjegyzék attribútumai segítségével információkat adhat meg a szerelvényjegyzékben, beleértve a címet, a leírást, az alapértelmezett aliast és a konfigurációt. Az alábbi táblázat az összeállításjegyzék jellemzőit ismerteti.

Szerelvényjegyzék attribútuma Leírás
AssemblyConfigurationAttribute A szerelvény konfigurációját jelző sztringérték, például a Retail vagy a Debug. A futtatókörnyezet nem használja ezt az értéket.
AssemblyDefaultAliasAttribute A szerelvényekre való hivatkozáshoz használandó alapértelmezett aliast meghatározó karakterláncérték. Ez az érték felhasználóbarát nevet ad, ha maga a szerelvény neve nem felhasználóbarát (például GUID-érték). Ez az érték a teljes szerelvénynév rövid formájaként is használható.
AssemblyDescriptionAttribute Sztringérték, amely egy rövid leírást ad meg, amely összefoglalja a szerelvény jellegét és célját.
AssemblyTitleAttribute A szerelvény barátságos nevét meghatározó karakterláncérték. Előfordulhat például, hogy egy comdlg nevű szerelvény a Microsoft Common Dialog Control nevet viseli.

Erős névattribútumok

Erős név attribútumok használatával beállíthatja az összeállítás erős nevét. Az alábbi táblázat az erős névattribútumokat ismerteti.

Erős névattribútum Leírás
AssemblyDelaySignAttribute Logikai érték, amely azt jelzi, hogy a késleltetési aláírás használva van.
AssemblyKeyFileAttribute Sztringérték, amely a nyilvános kulcsot tartalmazó fájl nevét jelzi (késleltetési aláírás esetén), vagy az attribútum konstruktorának paraméterként átadott nyilvános és titkos kulcsokat. Vegye figyelembe, hogy a fájlnév a kimeneti fájl elérési útjának ( a.exe vagy a.dll) relatív neve, nem pedig a forrásfájl elérési útja.
AssemblyKeyNameAttribute Azt a kulcstárolót jelzi, amely az attribútum konstruktorának paraméterként átadott kulcspárt tartalmazza.

Az alábbi kódpélda bemutatja azokat az attribútumokat, amelyeket késleltetett aláírás használatakor kell alkalmazni egy erős nevű szerelvény létrehozásához egy myKey.snk nevű nyilvános kulcsfájllal.

[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];

[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]

<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>

Lásd még

  • Last updated on