Friend (Visual Basic)

Artigo
08/08/2011

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

Comentários

A seguinte classe usa a Friend modificador para permitir que outros elementos de programação dentro do mesmo assembly para acessar determinados membros.

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

Rules

Declaration Context. You can use Friend only at module, interface, or namespace level. This means the declaration context for a Friend element must be a source file, namespace, interface, module, class, or structure, and cannot be a procedure.
Combined Modifiers. Você pode usar o Friend modificador em conjunto com o Protegido (Visual Basic) modificador na mesma declaração. Essa combinação confere amigo e acesso protegido em elementos declarados, para que sejam acessíveis de qualquer lugar no mesmo assembly, de sua própria classee de classes derivadas. You can specify Protected Friend only on members of classes.

Behavior

Nível de acesso. Tudo o código em umcontexto de declaraçãopode acessar seus elementos. Código em outras classes, estruturas e módulos são compilados para o mesmo assembly pode acessar todos os Friend elementos no assembly.

Acesso Friend não é um superconjunto ou subconjunto de acesso protegido.
Modificadores de acesso. The keywords that specify access level are called access modifiers. For a comparison of the access modifiers, see Níveis de acesso em Visual Basic.

Quando usar o amigo

Em muitos casos, você deseja programação elementos como, por exemplo, classes e estruturas para ser usado pelo todo assembly, não apenas o componente que declara-los. No entanto, não convém possam ser acessados por código fora do assembly, por exemplo, se o aplicativo é proprietário. Se você desejar limitar o acesso a um elemento dessa maneira, você pode declará-lo com Friend.

Acesso Friend costuma ser o nível preferido para elementos de programação do aplicativo. Observe que o nível de acesso de uma interface, módulo, classeou estrutura padrão é Friend se você não declarar-caso contrário.

The Friend modifier can be used in these contexts: