Compartilhar via


Como declarar uma estrutura (Visual Basic)

Você inicia uma declaração de estrutura com a Instrução Structure e a encerra com a instrução End Structure. Entre essas duas instruções, você deve declarar pelo menos um elemento. Os elementos podem ser de qualquer tipo de dados, mas pelo menos um deve ser uma variável não compartilhada ou um evento não compartilhado e não personalizado.

Não é possível inicializar nenhum dos elementos de estrutura na declaração de estrutura. Quando você declara uma variável como de um tipo de estrutura, atribui valores aos elementos acessando-os por meio da variável.

Para uma discussão sobre as diferenças entre estruturas e classes, consulte Estruturas e Classes.

Para fins de demonstração, considere uma situação em que você deseja controlar o nome, a extensão telefônica e o salário de um funcionário. Uma estrutura permite que você faça isso em uma única variável.

Para declarar uma estrutura

  1. Crie as instruções de início e término para a estrutura.

    Você pode especificar o nível de acesso de uma estrutura usando a palavra-chave Pública, Protegida, Amiga ou Privada ou pode deixá-la padrão Public.

    Private Structure employee  
    End Structure  
    
  2. Adicione elementos ao corpo da estrutura.

    Uma estrutura deve ter pelo menos um elemento. Você deve declarar cada elemento e especificar um nível de acesso para ele. Se você usar a Instrução Dim sem palavras-chave, a acessibilidade será padrão Public.

    Private Structure employee  
        Public givenName As String  
        Public familyName As String  
        Public phoneExtension As Long  
        Private salary As Decimal  
        Public Sub giveRaise(raise As Double)  
            salary *= raise  
        End Sub  
        Public Event salaryReviewTime()  
    End Structure  
    

    O campo salary no exemplo anterior é Private, o que significa que ele está inacessível fora da estrutura, mesmo da classe que contém. No entanto, o procedimento giveRaise é Public; portanto, pode ser chamado de fora da estrutura. Da mesma forma, você pode gerar o evento salaryReviewTime de fora da estrutura.

    Além de variáveis, os procedimentos Sub e eventos, você também pode definir constantes, procedimentos Function e propriedades em uma estrutura. Você pode designar no máximo uma propriedade como a propriedade padrão, desde que ela utilize pelo menos um argumento. Você pode lidar com um evento com um procedimento CompartilhadoSub. Para obter mais informações, consulte Como declarar e chamar uma propriedade padrão no Visual Basic.

Confira também