Megosztás a következőn keresztül:


Attribútumlista (Visual Basic)

Meghatározza a deklarált programozási elemekre alkalmazandó attribútumokat. Több attribútumot vessző választ el egymástól. Az alábbiakban egy attribútum szintaxisa található.

Syntax

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]  

Részek

Része Leírás
attributemodifier A forrásfájl elején alkalmazott attribútumokhoz szükséges. Lehet szerelvény vagy modul.
attributename Szükséges. Az attribútum neve.
attributearguments Opcionális. Az attribútum pozícióargumentumainak listája. Több argumentumot vessző választ el egymástól.
attributeinitializer Opcionális. Az attribútum változó- vagy tulajdonság-inicializálóinak listája. Több inicializálót vessző választ el egymástól.

Megjegyzések

Egy vagy több attribútumot szinte bármilyen programozási elemre alkalmazhat (típusok, eljárások, tulajdonságok stb.). Az attribútumok megjelennek a szerelvény metaadataiban, és segíthetnek a kód széljegyzetelésében vagy egy adott programozási elem használatának megadásában. A Visual Basic és a .NET-keretrendszer által definiált attribútumokat alkalmazhatja, és saját attribútumokat is definiálhat.

További információ az attribútumok használatáról: Attribútumok áttekintése. Az attribútumnevekről további információt a Deklarált elemnevek című témakörben talál.

Szabályok

  • Elhelyezés. Attribútumokat alkalmazhat a legtöbb deklarált programozási elemre. Egy vagy több attribútum alkalmazásához egy attribútumblokkot kell elhelyeznie az elemdeklaráció elején. Az attribútumlista minden bejegyzése megadja az alkalmazni kívánt attribútumot, valamint az attribútum meghívásához használt módosítót és argumentumokat.

  • Szögletes zárójelek. Ha attribútumlistát ad meg, szögletes zárójelek ("<" és ">") közé kell foglalnia.

  • A nyilatkozat része. Az attribútumnak az elemdeklaráció részét kell képeznie, nem pedig külön utasításnak. A sor-folytatás sorozat (" _") használatával kiterjesztheti a deklarációs utasítást több forráskódsorra.

  • Módosítók. A forrásfájl elején egy programozási elemre alkalmazott attribútum-módosító (Assembly vagy Module) szükséges. Az attribútummódosítók nem engedélyezettek a forrásfájl elején nem szereplő elemekre alkalmazott attribútumokon.

  • Érvek. Az attribútum minden pozícióargumentumának megelőznie kell bármely változót vagy tulajdonság inicializálót.

Példa

Az alábbi példa egy eljárás csontvázdefiníciójára alkalmazza az DllImportAttribute attribútumot Function .

<DllImportAttribute("kernel32.dll", EntryPoint:="MoveFileW",
    SetLastError:=True, CharSet:=CharSet.Unicode,
    ExactSpelling:=True,
    CallingConvention:=CallingConvention.StdCall)>
Public Shared Function MoveFile(ByVal src As String,
  ByVal dst As String) As Boolean
    ' This function copies a file from the path src to the path dst.
    ' Leave this function empty. The DLLImport attribute forces calls
    ' to MoveFile to be forwarded to MoveFileW in KERNEL32.DLL.
End Function

DllImportAttribute azt jelzi, hogy az attribútumalapú eljárás egy nem felügyelt dinamikus csatolású kódtár (DLL) belépési pontját jelöli. Az attribútum a DLL-nevet pozícióargumentumként, a többi információt pedig változó inicializálóként adja meg.

Lásd még