Seznam atributů (Visual Basic)

  • Článek

Určuje atributy, které mají být použity na deklarovaný programovací prvek. Více atributů je odděleno čárkami. Následuje syntaxe jednoho atributu.

Syntaxe

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Součástky

Část Popis
attributemodifier Požadováno pro atributy použité na začátku zdrojového souboru. Může to být sestavení nebo modul.
attributename Povinný: Název atributu
attributearguments Nepovinné. Seznam pozičních argumentů pro tento atribut Více argumentů je odděleno čárkami.
attributeinitializer Nepovinné. Seznam inicializátorů proměnných nebo vlastností pro tento atribut Více inicializátorů je odděleno čárkami.

Poznámky

Jeden nebo více atributů můžete použít téměř u jakéhokoli programovacího prvku (typy, procedury, vlastnosti atd.). Atributy se zobrazí v metadatech sestavení a můžou vám pomoct při přidávání poznámek ke kódu nebo určení způsobu použití konkrétního programovacího prvku. Můžete použít atributy definované jazykem Visual Basic a rozhraním .NET Framework a můžete definovat vlastní atributy.

Další informace o tom, kdy použít atributy, naleznete v tématu Přehled atributů. Informace o názvech atributů naleznete v části Deklarované názvy elementů.

Pravidla

  • Umístění. Atributy můžete použít u většiny deklarovaných programovacích prvků. Chcete-li použít jeden nebo více atributů, umístíte blok atributu na začátek deklarace elementu. Každá položka v seznamu atributů určuje atribut, který chcete použít, a modifikátor a argumenty, které používáte pro toto vyvolání atributu.

  • Úhlové závorky. Pokud zadáte seznam atributů, musíte ho uzavřít do úhlových závorek ("<" a ">").

  • Část deklarace. Atribut musí být součástí deklarace elementu, nikoli samostatný příkaz. Pomocí sekvence pokračování řádku (" _") můžete rozšířit příkaz deklarace na více řádků zdrojového kódu.

  • Modifikátory. Modifikátor atributu (Assembly nebo Module) je vyžadován u každého atributu použitého na programovací prvek na začátku zdrojového souboru. Modifikátory atributů nejsou povoleny u atributů použitých u prvků, které nejsou na začátku zdrojového souboru.

  • Argumenty. Všechny poziční argumenty atributu musí předcházet jakékoli proměnné nebo inicializátory vlastností.

Příklad

Následující příklad použije DllImportAttribute atribut na definici Function kostry procedury.

<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 označuje, že atributový postup představuje vstupní bod v nespravované dynamické knihovně (DLL). Atribut poskytuje název knihovny DLL jako poziční argument a další informace jako inicializátory proměnných.

Viz také