Lista atrybutów (Visual Basic)

Artykuł
03/12/2024

Określa atrybuty, które mają być stosowane do zadeklarowanego elementu programowania. Wiele atrybutów jest rozdzielonych przecinkami. Poniżej znajduje się składnia jednego atrybutu.

Składnia

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

generatora

Element	opis
`attributemodifier`	Wymagane dla atrybutów zastosowanych na początku pliku źródłowego. Może to być zestaw lub moduł.
`attributename`	Wymagany. Nazwa atrybutu.
`attributearguments`	Opcjonalny. Lista argumentów pozycyjnych dla tego atrybutu. Wiele argumentów jest rozdzielonych przecinkami.
`attributeinitializer`	Opcjonalny. Lista inicjatorów zmiennych lub właściwości dla tego atrybutu. Wiele inicjatorów jest rozdzielonych przecinkami.

Uwagi

Można zastosować co najmniej jeden atrybut do niemal dowolnego elementu programowania (typów, procedur, właściwości itd.). Atrybuty są wyświetlane w metadanych zestawu i mogą pomóc w dodawaniu adnotacji do kodu lub określaniu sposobu użycia określonego elementu programowania. Atrybuty zdefiniowane przez program Visual Basic i program .NET Framework można zastosować, a także zdefiniować własne atrybuty.

Aby uzyskać więcej informacji na temat używania atrybutów, zobacz Omówienie atrybutów. Aby uzyskać informacje na temat nazw atrybutów, zobacz Zadeklarowane nazwy elementów.

Reguły

Umieszczenie. Atrybuty można zastosować do większości zadeklarowanych elementów programowania. Aby zastosować co najmniej jeden atrybut, należy umieścić blok atrybutów na początku deklaracji elementu. Każdy wpis na liście atrybutów określa atrybut, który chcesz zastosować, oraz modyfikator i argumenty używane dla tego wywołania atrybutu.
Nawiasy. Jeśli podasz listę atrybutów, musisz ująć ją w nawiasy kątowe ("<" i ">").
Część deklaracji. Atrybut musi być częścią deklaracji elementu, a nie oddzielnej instrukcji. Możesz użyć sekwencji kontynuacji wiersza (" _"), aby rozszerzyć instrukcję deklaracji na wiele wierszy kodu źródłowego.
Modyfikatorów. Modyfikator atrybutów (Assembly lub Module) jest wymagany dla każdego atrybutu zastosowanego do elementu programowania na początku pliku źródłowego. Modyfikatory atrybutów nie są dozwolone dla atrybutów zastosowanych do elementów, które nie znajdują się na początku pliku źródłowego.
Argumenty. Wszystkie argumenty pozycyjne atrybutu muszą poprzedzać wszystkie inicjatory zmiennych lub właściwości.

Przykład

Poniższy przykład stosuje DllImportAttribute atrybut do definicji szkieletu Function 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 wskazuje, że procedura przypisana reprezentuje punkt wejścia w niezarządzanej bibliotece linków dynamicznych (DLL). Atrybut dostarcza nazwę biblioteki DLL jako argument pozycyjny i inne informacje jako inicjatory zmiennych.

Udostępnij za pośrednictwem