Attributliste (Visual Basic)

  • Artikel

Gibt die Attribute an, die auf ein deklariertes Programmierelement angewendet werden sollen. Mehrere Attribute werden durch Kommas getrennt. Es folgt die Syntax für ein Attribut.

Syntax

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Bestandteile

Teil Beschreibung
attributemodifier Erforderlich für Attribute, die am Anfang einer Quelldatei angewendet werden. Kann Assembly oder Modul sein.
attributename Erforderlich. Der Name des Attributs.
attributearguments Optional. Liste der Positionsargumente für dieses Attribut. Mehrere Argumente werden durch Kommas voneinander getrennt.
attributeinitializer Optional. Liste der Variablen- oder Eigenschaftsinitialisierer für dieses Attribut. Mehrere Initialisierer werden durch Kommas getrennt.

Bemerkungen

Sie können mindestens ein Attribut auf nahezu jedes Programmierelement anwenden (Typen, Prozeduren, Eigenschaften usw.). Attribute werden in den Metadaten Ihrer Assembly angezeigt, und sie können Ihnen dabei helfen, den Code zu kommentieren oder anzugeben, wie ein bestimmtes Programmierelement verwendet werden soll. Sie können Attribute anwenden, die von Visual Basic und .NET Framework definiert sind, und Sie können eigene Attribute definieren.

Weitere Informationen zur Verwendung von Attributen finden Sie in der Übersicht über Attribute. Informationen zu Attributnamen finden Sie unter Deklarierte Elementnamen.

Regeln

  • Platzierung: Sie können Attribute auf die meisten deklarierten Programmierelemente anwenden. Um ein oder mehrere Attribute anzuwenden, platzieren Sie einen Attributblock am Anfang der Elementdeklaration. Jeder Eintrag in der Attributliste gibt ein Attribut an, das Sie anwenden möchten, sowie den Modifizierer und die Argumente, die Sie für diesen Aufruf des Attributs verwenden.

  • Spitze Klammern: Wenn Sie eine Attributliste angeben, müssen Sie sie in spitze Klammern („<“ und „>“) einschließen.

  • Teil der Deklaration: Das Attribut muss Teil der Elementdeklaration sein, keine separate Anweisung. Sie können die Zeilenfortsetzungssequenz („_“) verwenden, um die Deklarationsanweisung auf mehrere Quellcodezeilen zu erweitern.

  • Modifizierer: Ein Attributmodifizierer (Assembly oder Module) ist für jedes Attribut erforderlich, das auf ein Programmierelement am Anfang einer Quelldatei angewendet wird. Attributmodifizierer sind für Attribute nicht zulässig, die auf Elemente angewendet werden, die sich nicht am Anfang einer Quelldatei befinden.

  • Argumente: Alle Positionsargumente für ein Attribut müssen Variablen- oder Eigenschaftsinitialisierern vorausgehen.

Beispiel

Im folgenden Beispiel wird das DllImportAttribute-Attribut auf eine Skelettdefinition einer Function-Prozedur angewendet.

<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 gibt an, dass die attributierte Prozedur einen Einstiegspunkt in eine nicht verwalteten Dynamic Link Library (DLL) darstellt. Das Attribut stellt den DLL-Namen als Positionsargument und die anderen Informationen als Variableninitialisierer bereit.

Siehe auch