Compartilhar via

Atributos comuns (Visual Basic)

Este tópico descreve os atributos mais usados em programas do Visual Basic.

Atributos globais

A maioria dos atributos é aplicada a elementos de linguagem específicos, como classes ou métodos; no entanto, alguns atributos são globais , eles se aplicam a um assembly ou módulo inteiro. Por exemplo, o AssemblyVersionAttribute atributo pode ser usado para inserir informações de versão em um assembly, assim:

<Assembly: AssemblyVersion("1.0.0.0")>

Os atributos globais aparecem no código-fonte após quaisquer instruções de nível Imports superior e antes de qualquer tipo, módulo ou declarações de namespace. Atributos globais podem aparecer em vários arquivos de origem, mas os arquivos devem ser compilados em uma única passagem de compilação. Para projetos do Visual Basic, os atributos globais geralmente são colocados no arquivo AssemblyInfo.vb (o arquivo é criado automaticamente quando você cria um projeto no Visual Studio).

Atributos de assemblagem são valores que fornecem informações sobre uma assemblagem. Eles se enquadram nas seguintes categorias:

  • Atributos de identidade do assembly

  • Atributos informativos

  • Atributos de manifesto do assembly

Atributos de Identidade do Assembly

Três atributos (com um nome forte, se aplicável) determinam a identidade de um assembly: nome, versão e cultura. Esses atributos formam o nome completo do assembly e são necessários quando você faz referência a ele no código. Você pode definir a versão e a cultura de um assembly, usando atributos. No entanto, o valor do nome é definido pelo compilador, pelo IDE do Visual Studio na caixa de diálogo de Informações do Assembly ou pelo Assembly Linker (Al.exe) quando o assembly é criado, com base no arquivo que contém o manifesto do assembly. O AssemblyFlagsAttribute atributo especifica se várias cópias do assembly podem coexistir.

A tabela a seguir mostra os atributos de identidade.

Atributo Propósito
AssemblyName Descreve completamente a identidade de um conjunto.
AssemblyVersionAttribute Especifica a versão de um assembly.
AssemblyCultureAttribute Especifica qual cultura o assembly dá suporte.
AssemblyFlagsAttribute Especifica se um assembly dá suporte à execução lado a lado no mesmo computador, no mesmo processo ou no mesmo domínio do aplicativo.

Atributos informativos

Você pode usar atributos informativos para fornecer informações adicionais da empresa ou do produto para uma montagem. A tabela a seguir mostra os atributos informativos definidos no System.Reflection namespace.

Atributo Propósito
AssemblyProductAttribute Define um atributo personalizado que especifica um nome de produto para um manifesto do assembly.
AssemblyTrademarkAttribute Define um atributo personalizado que especifica uma marca registrada para um manifesto do assembly.
AssemblyInformationalVersionAttribute Define um atributo personalizado que especifica uma versão informativa para um manifesto do assembly.
AssemblyCompanyAttribute Define um atributo personalizado que especifica um nome de empresa para um manifesto do assembly.
AssemblyCopyrightAttribute Define um atributo personalizado que especifica os direitos autorais para um manifesto do assembly.
AssemblyFileVersionAttribute Instrui o compilador a usar um número de versão específico para o recurso de versão do arquivo Win32.
CLSCompliantAttribute Indica se a assemblagem está em conformidade com a Especificação de Linguagem Comum (CLS).

Atributos de Manifesto do Assembly

Você pode usar atributos de manifesto do assembly para fornecer informações no manifesto do assembly. Isso inclui título, descrição, alias padrão e configuração. A tabela a seguir mostra os atributos de manifesto do assembly definidos no System.Reflection namespace.

Atributo Propósito
AssemblyTitleAttribute Define um atributo personalizado que especifica um título de assembly para um manifesto do assembly.
AssemblyDescriptionAttribute Define um atributo personalizado que especifica uma descrição de assembly para um manifesto do assembly.
AssemblyConfigurationAttribute Define um atributo personalizado que especifica uma configuração de assembly (como comercial ou de depuração) para um manifesto do assembly. assembly.
AssemblyDefaultAliasAttribute Define um alias amigável padrão para um manifesto do assembly

Atributo obsoleto

O Obsolete atributo marca uma entidade de programa como uma que não é mais recomendada para uso. Cada uso de uma entidade marcada como obsoleta gerará posteriormente um aviso ou um erro, dependendo de como o atributo é configurado. Por exemplo:

<System.Obsolete("use class B")>
Class A
    Sub Method()
    End Sub
End Class

Class B
    <System.Obsolete("use NewMethod", True)>
    Sub OldMethod()
    End Sub

    Sub NewMethod()
    End Sub
End Class

Neste exemplo, o Obsolete atributo é aplicado à classe A e ao método B.OldMethod. Como o segundo argumento do construtor de atributo aplicado B.OldMethod é definido como true, esse método causará um erro do compilador, enquanto o uso da classe A produzirá apenas um aviso. Chamar B.NewMethod, no entanto, não produz aviso nem erro.

A cadeia de caracteres fornecida como o primeiro argumento para o construtor de atributos será exibida como parte do aviso ou erro. Por exemplo, ao usá-lo com as definições anteriores, o código a seguir gera um erro e dois avisos:

' Generates 2 warnings:
' Dim a As New A
' Generate no errors or warnings:

Dim b As New B
b.NewMethod()

' Generates an error, terminating compilation:
' b.OldMethod()

São gerados dois avisos para a classe A: um para a declaração da referência de classe e outro para o construtor de classe.

O Obsolete atributo pode ser usado sem argumentos, mas incluindo uma explicação de por que o item é obsoleto e o que usar em vez disso é recomendado.

O atributo Obsolete é um atributo de uso único e pode ser aplicado a qualquer entidade que permite atributos. Obsolete é um alias para ObsoleteAttribute.

Atributo condicional

O atributo Conditional torna a execução de um método dependente de um identificador de pré-processamento. O atributo Conditional é um alias para ConditionalAttribute e pode ser aplicado a um método ou uma classe de atributo.

Neste exemplo, Conditional é aplicado a um método para habilitar ou desabilitar a exibição de informações de diagnóstico específicas do programa:

#Const TRACE_ON = True
Imports System.Diagnostics

Module TestConditionalAttribute
    Public Class Trace
        <Conditional("TRACE_ON")>
        Public Shared Sub Msg(ByVal msg As String)
            Console.WriteLine(msg)
        End Sub

    End Class

    Sub Main()
        Trace.Msg("Now in Main...")
        Console.WriteLine("Done.")
    End Sub
End Module

Se o TRACE_ON identificador não estiver definido, nenhuma saída de rastreamento será exibida.

O atributo Conditional é frequentemente usado com o identificador DEBUG para habilitar recursos de rastreamento e de registro em log para builds de depuração, mas não em builds de versão, dessa maneira:

<Conditional("DEBUG")>
Shared Sub DebugMethod()

End Sub

Quando um método marcado como condicional é chamado, a presença ou ausência do símbolo de pré-processamento especificado determina se a chamada é incluída ou omitida. Se o símbolo estiver definido, a chamada será incluída, caso contrário, a chamada será omitida. Usar Conditional é uma alternativa mais limpa, mais elegante e menos propensa a erros para colocar métodos dentro #if…#endif de blocos, desta forma:

#If DEBUG Then
    Sub ConditionalMethod()
    End Sub
#End If

Um método condicional deve ser um método em uma declaração de classe ou struct e não deve ter um valor retornado.

Usando vários identificadores

Se um método tiver vários Conditional atributos, uma chamada ao método será incluída se pelo menos um dos símbolos condicionais for definido (em outras palavras, os símbolos serão logicamente vinculados usando o operador OR). Neste exemplo, a presença de A ou B resultará em uma chamada de método.

<Conditional("A"), Conditional("B")>
Shared Sub DoIfAorB()

End Sub

Para obter o efeito de vincular logicamente símbolos usando o operador AND, você pode definir métodos condicionais de série. Por exemplo, o segundo método a seguir será executado somente se ambos A e B forem definidos:

<Conditional("A")>
Shared Sub DoIfA()
    DoIfAandB()
End Sub

<Conditional("B")>
Shared Sub DoIfAandB()
    ' Code to execute when both A and B are defined...
End Sub

Usando classes condicionais com atributos

O atributo Conditional também pode ser aplicado a uma definição de classe de atributos. Neste exemplo, o atributo Documentation personalizado só adicionará informações aos metadados se DEBUG for definido.

<Conditional("DEBUG")>
Public Class Documentation
    Inherits System.Attribute
    Private text As String
    Sub New(ByVal doc_text As String)
        text = doc_text
    End Sub
End Class

Class SampleClass
    ' This attribute will only be included if DEBUG is defined.
    <Documentation("This method displays an integer.")>
    Shared Sub DoWork(ByVal i As Integer)
        System.Console.WriteLine(i)
    End Sub
End Class

Atributos de informações do chamador

Usando atributos de Informações do Chamador, você pode obter informações sobre o chamador para um método. Você pode obter o caminho do arquivo do código-fonte, o número da linha no código-fonte e o nome do membro do chamador.

Para obter informações do membro que está chamando, use atributos aplicados a parâmetros opcionais. Cada parâmetro opcional especifica um valor padrão. A tabela a seguir lista os atributos de Informações do Chamador definidos no System.Runtime.CompilerServices namespace:

Atributo Descrição Tipo
CallerFilePathAttribute O caminho completo do arquivo de origem que contém o chamador. Esse é o caminho no momento de compilação. String
CallerLineNumberAttribute Número de linha no arquivo de origem do qual o método é chamado. Integer
CallerMemberNameAttribute Nome do método ou nome da propriedade do chamador. Para obter mais informações, consulte Informações do Chamador (Visual Basic). String
CallerArgumentExpressionAttribute Expressão usada pelo chamador para um argumento. Para obter mais informações, consulte Informações do Chamador (Visual Basic). String

Para obter mais informações sobre os atributos de Informações do Chamador, consulte Informações do Chamador (Visual Basic).

Atributos do Visual Basic

A tabela a seguir lista os atributos específicos do Visual Basic.

Atributo Propósito
ComClassAttribute Indica ao compilador que a classe deve ser exposta como um objeto COM.
HideModuleNameAttribute Permite que os membros do módulo sejam acessados usando apenas a qualificação necessária para o módulo.
VBFixedStringAttribute Especifica o tamanho de uma cadeia de caracteres de comprimento fixo em uma estrutura para uso com funções de entrada e saída de arquivo.
VBFixedArrayAttribute Especifica o tamanho de uma matriz fixa em uma estrutura para uso com funções de entrada e saída de arquivo.

COMClassAttribute

Use COMClassAttribute para simplificar o processo de criação de componentes COM do Visual Basic. Os objetos COM são consideravelmente diferentes dos assemblies do .NET Framework e, sem COMClassAttribute, você precisa seguir várias etapas para gerar um objeto COM do Visual Basic. Para classes marcadas com COMClassAttribute, o compilador executa muitas dessas etapas automaticamente.

HideModuleNameAttribute

Use HideModuleNameAttribute para permitir que os membros do módulo sejam acessados usando apenas a qualificação necessária para o módulo.

VBFixedStringAttribute

Use VBFixedStringAttribute para forçar o Visual Basic a criar uma cadeia de caracteres de comprimento fixo. As cadeias de caracteres têm comprimento variável por padrão e esse atributo é útil ao armazenar cadeias de caracteres em arquivos. O código a seguir demonstra isso:

Structure Worker
    ' The runtime uses VBFixedString to determine
    ' if the field should be written out as a fixed size.
    <VBFixedString(10)> Public LastName As String
    <VBFixedString(7)> Public Title As String
    <VBFixedString(2)> Public Rank As String
End Structure

VBFixedArrayAttribute

Use VBFixedArrayAttribute para declarar matrizes fixas em tamanho. Assim como as cadeias de caracteres do Visual Basic, as matrizes são de comprimento variável por padrão. Esse atributo é útil ao serializar ou gravar dados em arquivos.

Consulte também

  • Last updated on