Compartir a través de

Lista de atributos (Visual Basic)

Especifica los atributos que se van a aplicar a un elemento de programación declarado. Varios atributos están separados por comas. A continuación se muestra la sintaxis de un atributo.

Sintaxis

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Partes

Parte Descripción
attributemodifier Necesario para los atributos aplicados al principio de un archivo de origen. Puede ser Ensamblado o Módulo.
attributename Obligatorio. Nombre del atributo.
attributearguments Opcional. Lista de argumentos posicionales para este atributo. Varios argumentos están separados por comas.
attributeinitializer Opcional. Lista de inicializadores de variables o propiedades para este atributo. Varios inicializadores están separados por comas.

Observaciones

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 anotar el código o 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 Introducción a los atributos. Para obtener información sobre los nombres de atributo, vea Nombres de elementos declarados.

Reglas

  • Colocació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 desea aplicar y el modificador y los argumentos que usa 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 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 o Module) en todos los atributos aplicados a un elemento de programación al principio de un archivo de origen. Los modificadores de atributo no se permiten 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 DllImportAttribute atributo a una definición de esqueleto de un Function procedimiento.

<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 dll como argumento posicional y la otra información como inicializadores de variables.

Consulte también

  • Last updated on