Share via

Attributlista (Visual Basic)

  • Artikel

Anger de attribut som ska tillämpas på ett deklarerat programmeringselement. Flera attribut avgränsas med kommatecken. Följande är syntaxen för ett attribut.

Syntax

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Delar

Delvis beskrivning
attributemodifier Krävs för attribut som tillämpas i början av en källfil. Kan vara sammansättning eller modul.
attributename Obligatoriska. Namnet på attributet.
attributearguments Valfritt. Lista över positionella argument för det här attributet. Flera argument avgränsas med kommatecken.
attributeinitializer Valfritt. Lista över variabel- eller egenskapsinitierare för det här attributet. Flera initialiserare avgränsas med kommatecken.

Kommentarer

Du kan använda ett eller flera attribut för nästan alla programmeringselement (typer, procedurer, egenskaper och så vidare). Attribut visas i din sammansättnings metadata och de kan hjälpa dig att kommentera koden eller ange hur du använder ett visst programmeringselement. Du kan använda attribut som definierats av Visual Basic och .NET Framework, och du kan definiera dina egna attribut.

Mer information om när du ska använda attribut finns i Översikt över attribut. Information om attributnamn finns i Deklarerade elementnamn.

Regler

  • Placering. Du kan använda attribut för de flesta deklarerade programmeringselement. Om du vill använda ett eller flera attribut placerar du ett attributblock i början av elementdeklarationen. Varje post i attributlistan anger ett attribut som du vill använda och den modifierare och de argument som du använder för det här anropet av attributet.

  • Vinkelparenteser. Om du anger en attributlista måste du omsluta den i vinkelparenteser ("<" och ">").

  • En del av förklaringen. Attributet måste vara en del av elementdeklarationen, inte en separat instruktion. Du kan använda radfortsättningssekvensen (" _") för att utöka deklarationssatsen till flera källkodsrader.

  • Modifierare. En attributmodifierare (Assembly eller Module) krävs för varje attribut som tillämpas på ett programmeringselement i början av en källfil. Attributmodifierare tillåts inte för attribut som tillämpas på element som inte är i början av en källfil.

  • Argument. Alla positionsargument för ett attribut måste föregå alla variabel- eller egenskapsinitierare.

Exempel

I följande exempel tillämpas attributet på DllImportAttribute en skelettdefinition av en Function procedur.

<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 anger att den tillskrivna proceduren representerar en startpunkt i ett ohanterat DLL-bibliotek (Dynamic Link Library). Attributet tillhandahåller DLL-namnet som ett positionsargument och den andra informationen som variabelinitierare.

Se även