Share via

Lijst met kenmerken (Visual Basic)

  • Artikel

Hiermee geeft u de kenmerken die moeten worden toegepast op een gedeclareerd programmeerelement. Meerdere kenmerken worden gescheiden door komma's. Hier volgt de syntaxis voor één kenmerk.

Syntaxis

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

generator

Onderdeel Beschrijving
attributemodifier Vereist voor kenmerken die zijn toegepast aan het begin van een bronbestand. Kan assembly of module zijn.
attributename Vereist. Naam van het kenmerk.
attributearguments Optioneel. Lijst met positionele argumenten voor dit kenmerk. Meerdere argumenten worden gescheiden door komma's.
attributeinitializer Optioneel. Lijst met initialisatiefunctie voor variabelen of eigenschappen voor dit kenmerk. Meerdere initializers worden gescheiden door komma's.

Opmerkingen

U kunt een of meer kenmerken toepassen op vrijwel elk programmeerelement (typen, procedures, eigenschappen, enzovoort). Kenmerken worden weergegeven in de metagegevens van uw assembly en ze kunnen u helpen bij het maken van aantekeningen bij uw code of het gebruik van een bepaald programmeerelement. U kunt kenmerken toepassen die zijn gedefinieerd door Visual Basic en .NET Framework en u kunt uw eigen kenmerken definiëren.

Zie het overzicht kenmerken voor meer informatie over het gebruik van kenmerken. Zie Gedeclareerde elementnamen voor meer informatie over kenmerknamen.

Regels

  • Plaatsing. U kunt kenmerken toepassen op de meeste gedeclareerde programmeerelementen. Als u een of meer kenmerken wilt toepassen, plaatst u een kenmerkblok aan het begin van de elementdeclaratie. Elke vermelding in de lijst met kenmerken geeft een kenmerk op dat u wilt toepassen, en de wijziging en argumenten die u gebruikt voor deze aanroep van het kenmerk.

  • Punthaken. Als u een lijst met kenmerken opgeeft, moet u deze tussen punthaken ("<" en ">").

  • Deel van de verklaring. Het kenmerk moet deel uitmaken van de elementdeclaratie, niet een afzonderlijke instructie. U kunt de regelvolgorde (" _") gebruiken om de declaratie-instructie uit te breiden naar meerdere broncoderegels.

  • Modifiers. Een kenmerkaanpassing (Assembly of Module) is vereist voor elk kenmerk dat wordt toegepast op een programmeerelement aan het begin van een bronbestand. Kenmerkaanpassingen zijn niet toegestaan voor kenmerken die zijn toegepast op elementen die zich niet aan het begin van een bronbestand bevinden.

  • Argumenten. Alle positionele argumenten voor een kenmerk moeten voorafgaan aan een variabele of eigenschaps initialisatiefunctie.

Opmerking

In het volgende voorbeeld wordt het DllImportAttribute kenmerk toegepast op een basisdefinitie van een Function procedure.

<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 geeft aan dat de toegewezen procedure een toegangspunt in een niet-beheerde DYNAMIC-Link Library (DLL) vertegenwoordigt. Het kenmerk levert de DLL-naam als een positioneel argument en de andere informatie als variabele initializers.

Zie ook