Amigo (Visual Basic)

Artigo
02/25/2013

Especifica que um ou mais elementos de programação declarados só podem ser acessados no assembly que contém sua declaração.

Comentários

Em muitos casos, você deseja que os elementos de programação como classes e estruturas para ser usadas pelo conjunto inteiro, não apenas pelo componente que a declara.No entanto, você não pode desejar-los para ser acessível pelo código fora do assembly (por exemplo, se o aplicativo é proprietário).Se você desejar limitar essa maneira o acesso a um elemento, você pode declará-lo usando o modificador de Friend .

O código em outras classes, estruturas, módulos e que são compilados no mesmo assembly pode acessar todos os elementos de Friend naquele assembly.

acesso deFriend o nível é geralmente preferido para elementos de programação de aplicativo, e Friend é o nível de acesso padrão de uma interface, módulo, de classe, ou de uma estrutura.

Você pode usar Friend somente a interface, módulo, ou nível de namespace.Como consequência, o contexto da declaração para um elemento de Friend deve ser um arquivo fonte, namespace, interface, módulo, de classe ou estrutura;, não um procedimento.

Você pode usar o modificador de Friend em conjunto com o modificador de Protegido (Visual Basic) na declaração.Essa combinação confere ambos acesso de Friend e acesso protegido em elementos declarados, o que são acessíveis em qualquer lugar no mesmo assembly, de sua própria classe, e classes derivadas.Você pode especificar Protected Friend somente em membros de classes.

Para uma comparação de Friend e outros modificadores de acesso, consulte o Níveis de acesso em Visual Basic.

Observação
Você pode especificar que outro assembly é um assembly autorizado, que permite que acessa todos os tipos e membros que estejam marcadas como Friend.Para obter mais informações, consulte Friend Assemblies (C# e Visual Basic).

Exemplo

A seguinte classe usa o modificador de Friend para permitir que outros elementos de programação no mesmo assembly para alguns membros de acesso.

Class CustomerInfo

    Private p_CustomerID As Integer

    Public ReadOnly Property CustomerID() As Integer
        Get
            Return p_CustomerID
        End Get
    End Property

    ' Allow friend access to the empty constructor.
    Friend Sub New()

    End Sub

    ' Require that a customer identifier be specified for the public constructor.
    Public Sub New(ByVal customerID As Integer)
        p_CustomerID = customerID
    End Sub

    ' Allow friend programming elements to set the customer identifier.
    Friend Sub SetCustomerID(ByVal customerID As Integer)
        p_CustomerID = customerID
    End Sub
End Class