Friend (Visual Basic)

Artículo
08/10/2011

Especifica que sólo se puede tener acceso a uno o varios elementos de programación declarados desde el ensamblado que contiene su declaración.

Comentarios

La siguiente clase usa el modificador Friend para permitir a otros elementos de programación dentro del mismo ensamblado tener acceso a ciertos miembros.

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

Reglas

Contexto de la declaración. Puede utilizar Friend solamente en el nivel de módulo, interfaz o espacio de nombres. Esto significa que el contexto de declaración de un elemento Friend debe ser un archivo de código fuente, un espacio de nombres, una interfaz, un módulo, una clase o una estructura, y no un procedimiento.
Modificadores combinados. Puede utilizar el modificador Friend junto con el modificador Protected (Visual Basic) en la misma declaración. Esta combinación proporciona acceso de tipo amigo y acceso protegido a los elementos declarados para que sean accesibles desde cualquier punto del mismo ensamblado, desde su propia clase y desde cualquier clase derivada. Sólo puede especificar Protected Friend en miembros de clases.

Behavior

Nivel de acceso. Todo el código de un contexto de declaración puede tener acceso a sus elementos. El código de otras clases, estructuras y módulos que se compilan en el mismo ensamblado puede tener acceso a todos los elementos Friend de dicho ensamblado.

El acceso de tipo amigo no es un supraconjunto ni un subconjunto del acceso protegido.
Modificadores de acceso. Las palabras clave que especifican el nivel de acceso se llaman modificadores de acceso. Encontrará una comparación de los modificadores de acceso en Niveles de acceso en Visual Basic.

Cuándo se utiliza Friend

En numerosas ocasiones deseará que elementos de programación como clases y estructuras se utilicen en todo el ensamblado y no sólo en el componente en que se declaran. Sin embargo, posiblemente no desee que código ajeno al ensamblado tenga acceso a estos elementos, por ejemplo si se trata de una aplicación propia. Si desea limitar el acceso a un elemento de este modo, puede declararlo con Friend.

El acceso de tipo amigo suele ser el nivel preferido de los elementos de programación de una aplicación. Tenga en cuenta que el nivel de acceso de una interfaz, módulo, clase o estructura es Friend de manera predeterminada, si no se declara lo contrario.

El modificador Friend se puede utilizar en estos contextos:

Class (Instrucción)

Const (Instrucción)

Declare (Instrucción)

Delegate (Instrucción)

Dim (Instrucción)

Enum (Instrucción)

Event (Instrucción)

Function (Instrucción)

Interface (Instrucción)

Module (Instrucción)

Property (Instrucción)