Lista de atributos (Visual Basic)
Especifica los atributos que se van a aplicar a un elemento de programación declarado. Los diversos atributos se separan con comas. A continuación se muestra la sintaxis de un atributo.
Sintaxis
[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]
Partes
Parte | Descripción |
---|---|
attributemodifier |
Obligatorio para los atributos aplicados al principio de un archivo de origen. Puede ser Assembly o Module. |
attributename |
Necesario. Nombre del atributo. |
attributearguments |
Opcional. Lista de argumentos posicionales para este atributo. Los diversos argumentos se separan con comas. |
attributeinitializer |
Opcional. Lista de inicializadores de variables o propiedades para este atributo. Los diversos inicializadores se separan con comas. |
Comentarios
Puede aplicar uno o varios atributos a casi cualquier elemento de programación (tipos, procedimientos, propiedades, etc.). Los atributos aparecen en los metadatos del ensamblado y pueden ayudarle a realizar anotaciones en el código o a especificar cómo usar un elemento de programación determinado. Puede aplicar atributos definidos por Visual Basic y .NET Framework, y puede definir sus propios atributos.
Para obtener más información sobre cuándo usar atributos, consulte Información general sobre los atributos. Para obtener información sobre los nombres de atributo, consulte Nombres de elementos declarados.
Reglas
Ubicación. Puede aplicar atributos a la mayoría de los elementos de programación declarados. Para aplicar uno o varios atributos, coloque un bloque de atributos al principio de la declaración de elemento. Cada entrada de la lista de atributos especifica un atributo que quiere aplicar y el modificador y los argumentos que se usan para esta invocación del atributo.
Corchetes angulares. Si proporciona una lista de atributos, debe incluirla entre corchetes angulares ("
<
" y ">
").Parte de la declaración. El atributo debe formar parte de la declaración de elemento, no debe ser una instrucción independiente. Puede usar la secuencia de continuación de línea ("
_
") para extender la instrucción de declaración en varias líneas de código fuente.Modificadores. Se requiere un modificador de atributo (
Assembly
oModule
) en todos los atributos aplicados a un elemento de programación al principio de un archivo de origen. No se permiten modificadores de atributo en atributos aplicados a elementos que no están al principio de un archivo de origen.Argumentos. Todos los argumentos posicionales de un atributo deben preceder a cualquier inicializador de variable o propiedad.
Ejemplo
En el ejemplo siguiente se aplica el atributo DllImportAttribute a una definición de esqueleto de un procedimiento Function
.
<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 indica que el procedimiento con atributos representa un punto de entrada en una biblioteca de vínculos dinámicos (DLL) no administrada. El atributo proporciona el nombre de DLL como argumento posicional y la otra información como inicializadores de variable.