Seznam atributů (Visual Basic)

Článek
03/05/2024

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.

Sdílet prostřednictvím