Attributliste
Aktualisiert: November 2007
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 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 in Visual Basic und unter Allgemeine Verwendungszwecke für Attribute. Informationen über Attributnamen finden Sie unter Namen deklarierter Elemente.
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 zwischen spitze Klammern ("<" und ">") setzen.
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.
Siehe auch
Aufgaben
Gewusst wie: Umbrechen und Zusammenfassen von Anweisungen in Code
Konzepte
Allgemeine Verwendungszwecke für Attribute