Atributos personalizados en Visual Basic

Actualización: noviembre 2007

Los atributos personalizados son aquellos definidos por el usuario que proporcionan información adicional sobre elementos de programa. Por ejemplo, podría definir un atributo de seguridad personalizado que especifique los permisos necesarios del proceso que llama para ejecutar un procedimiento.

Puede definir atributos personalizados en clases de atributos basándose en la clase System.Attribute. Las clases de atributos propiamente dichas utilizan un atributo denominado AttributeUsageAttribute para proporcionar información adicional sobre cómo se pueden utilizar los atributos. Si especifica Inherited = True, indica que se puede propagar un atributo a clases derivadas. Si establece la propiedad AllowMultiple en True, podrá aplicar más de una instancia del atributo al elemento de programa. La enumeración AttributeTargets permite definir qué tipos de elementos de programa se pueden aplicar a sus atributos.

En el código siguiente, el atributo AttributeUsageAttribute especifica un atributo que se puede aplicar a cualquier tipo de elemento, heredado y sólo se aplica una vez:

<AttributeUsage(AttributeTargets.All, Inherited:=True, AllowMultiple:=False)> _
Class TestAttribute1
    Inherits Attribute
End Class

Puede utilizar el operador Or para combinar varios elementos de la enumeración AttributeTargets, como en el código siguiente:

<AttributeUsage(AttributeTargets.Class Or AttributeTargets.Method)> _
Class TestAttribute2
    Inherits Attribute
End Class

En esta sección

• Cómo: Definir atributos propios
  Explica cómo crear sus propios atributos utilizando clases de atributos.

• Cómo: Recuperar atributos personalizados
  Muestra cómo recuperar atributos personalizados mediante GetCustomAttribute u GetCustomAttributes.

• Ejemplos sobre el uso de atributos personalizados
  Proporciona código de ejemplo que define un atributo personalizado que se puede aplicar sólo a clases y muestra cómo utilizar el nuevo atributo.

Secciones relacionadas

• Visual Studio y .NET Framework
  Describe la función de Visual Basic en .NET Framework.

• Programación orientada a objetos en Visual Basic
  Proporciona información sobre la programación orientada a objetos y la forma de utilizarla.

• Metadatos y componentes autodescriptivos
  Proporciona información detallada sobre los tipos de metadatos utilizados en Visual Studio, incluidos los atributos.