Partilhar via


Como controlar a disponibilidade de uma variável (Visual Basic)

Você controla a disponibilidade de uma variável especificando seu nível de acesso. O nível de acesso determina qual código tem permissão para ler ou gravar na variável.

  • As variáveis de membro (definidas no nível do módulo e fora de qualquer procedimento) são padrão para acesso público, o que significa que qualquer código que possa vê-las pode acessá-las. Você pode alterar isso especificando um modificador de acesso.

  • As variáveis locais (definidas dentro de um procedimento) nominalmente têm acesso público, embora apenas o código dentro de seu procedimento possa acessá-las. Não é possível alterar o nível de acesso de uma variável local, mas é possível alterar o nível de acesso do procedimento que a contém.

Para obter mais informações, consulte Níveis de acesso no Visual Basic.

Acesso Privado e Público

Para tornar uma variável acessível somente de dentro de seu módulo, classe ou estrutura

  1. Coloque a instrução Dim para a variável dentro do módulo, classe ou estrutura, mas fora de qualquer procedimento.

  2. Inclua a palavra-chave Private na Dim instrução.

    Você pode ler ou gravar na variável de qualquer lugar dentro do módulo, classe ou estrutura, mas não de fora dele.

Para tornar uma variável acessível a partir de qualquer código que possa vê-la

  1. Para uma variável membro, coloque a Dim instrução para a variável dentro de um módulo, classe ou estrutura, mas fora de qualquer procedimento.

  2. Inclua a palavra-chave Public na Dim instrução.

    Você pode ler ou gravar na variável a partir de qualquer código que interopere com seu assembly.

-or-

  1. Para uma variável local, coloque a Dim instrução para a variável dentro de um procedimento.

  2. Não inclua a Public palavra-chave na Dim instrução.

    Você pode ler ou gravar na variável de qualquer lugar dentro do procedimento, mas não de fora dele.

Acesso protegido e de amigos

Você pode limitar o nível de acesso de uma variável à sua classe e a quaisquer classes derivadas ou ao seu assembly. Você também pode especificar a união dessas limitações, que permite o acesso do código em qualquer classe derivada ou em qualquer outro lugar no mesmo assembly. Você especifica essa união combinando as Protected palavras-chave e Friend na mesma declaração.

Para tornar uma variável acessível somente de dentro de sua classe e de quaisquer classes derivadas

  1. Coloque a Dim instrução para a variável dentro de uma classe, mas fora de qualquer procedimento.

  2. Inclua a palavra-chave Protected na Dim instrução.

    Você pode ler ou gravar na variável de qualquer lugar dentro da classe, bem como de dentro de qualquer classe derivada dela, mas não de fora de qualquer classe na cadeia de derivação.

Para tornar uma variável acessível somente de dentro do mesmo assembly

  1. Coloque a Dim instrução para a variável dentro de um módulo, classe ou estrutura, mas fora de qualquer procedimento.

  2. Inclua a palavra-chave Amigo na Dim declaração.

    Você pode ler ou gravar na variável de qualquer lugar dentro do módulo, classe ou estrutura, bem como de qualquer código no mesmo assembly, mas não de fora do assembly.

Exemplo

O exemplo a seguir mostra declarações de variáveis com Public, Protected, Friend, Protected Friende Private níveis de acesso. Observe que quando a Dim instrução especifica um nível de acesso, você não precisa incluir a Dim palavra-chave.

Public Class classForEverybody  
Protected Class classForMyHeirs  
Friend stringForThisProject As String  
Protected Friend stringForProjectAndHeirs As String  
Private numberForMeOnly As Integer  

Segurança do .NET Framework

Quanto mais restritivo for o nível de acesso de uma variável, menores serão as chances de que um código mal-intencionado possa fazer uso indevido dela.

Consulte também