Attributliste (Visual Basic)

Artikel
07/20/2011

Gibt die Attribute an, die auf ein deklariertes Programmierelement angewendet werden sollen. Mehrere Attribute werden durch Komma voneinander getrennt. Die folgenden Informationen zeigen die Syntax für ein Attribut.

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Bestandteile

attributemodifier
Erforderlich für Attribute, die am Anfang einer Quelldatei angewendet werden. Kann Assembly (Visual Basic) oder Modul sein.
attributename
Erforderlich. Name des Attributs.
attributearguments
Optional. Liste der Positionsargumente für dieses Attribut. Mehrere Argumente werden durch Komma voneinander getrennt.
attributeinitializer
Optional. Liste der Variablen- oder Eigenschafteninitialisierer für dieses Attribut. Mehrere Initialisierer werden durch Komma voneinander getrennt.

Hinweise

Sie können ein oder mehrere Attribute auf beinahe jedes Programmierelement (Typen, Prozeduren, Eigenschaften usw.) anwenden. Attribute treten in den Metadaten der Assembly auf. Sie können sie verwenden, um Anmerkungen in Ihrem Code zu machen oder um anzugeben, wie ein bestimmtes Programmierelement verwendet werden soll. Sie können von Visual Basic und .NET Framework definierte Attribute übernehmen und eigene Attribute definieren.

Weitere Informationen darüber, wann Attribute zu verwenden sind, finden Sie unter Attribute (C# und Visual Basic). Informationen über Attributnamen finden Sie unter Namen deklarierter Elemente (Visual Basic).

Regeln

Platzierung. Sie können Attribute auf die meisten deklarierten Programmierelemente anwenden. Um ein oder mehrere Attribute anzuwenden, fügen Sie am Anfang der Elementdeklaration einen Attributblock ein. Jeder Eintrag der Attributliste gibt ein anzuwendendes Attribut an sowie den Modifizierer und die Argumente, die für diesen Aufruf des Attributs verwendet werden.
Spitze Klammern. Wenn Sie eine Attributliste angeben, müssen Sie diese in spitze Klammern ("<" und ">") einschließen.
Teil der Deklaration. Das Attribut muss Teil der Elementdeklaration sein. Es darf keine separate Anweisung sein. Sie können die Zeilenfortsetzungssequenz (" _") verwenden, um die Deklarationsanweisung auf mehreren Quellcodezeilen zu erweitern.
Modifizierer. Für jedes Attribut, das zu Beginn einer Quelldatei auf ein Programmierelement angewendet wird, ist ein Attributmodifizierer (Assembly oder Module) erforderlich. Attributmodifizierer sind nicht zulässig für Attribute, die auf nicht am Anfang einer Quelldatei stehende Elemente angewendet werden.
Argumente. Alle Positionsargumente für ein Attribut müssen vor Variablen- oder Eigenschafteninitialisierungen stehen.

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 einer nicht verwalteten Dynamic Link Library (DLL) darstellt. Das Attribut gibt den DLL-Namen als Positionsargument und die anderen Informationen als Variableninitialisierungen an.