Friend (Visual Basic)

Artículo
06/08/2015

Especifica que solo se puede obtener acceso a uno o varios elementos de programación declarados desde dentro del ensamblado que contiene su declaración.

Comentarios

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, es posible que no se desee sea accesible por código fuera del ensamblado (por ejemplo, si la aplicación es propietaria). Si desea restringir el acceso a un elemento de esta manera, puede declararla utilizando el modificador de Friend.

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 Friend suele ser el nivel preferido para los elementos de programa de aplicación, y Friend es el nivel de acceso predeterminado de una interfaz, un módulo, una clase, o una estructura.

Puede utilizar Friend sólo en el módulo, la interfaz, o el nivel de espacio de nombres. Por consiguiente, el contexto de declaración para un elemento de Friend debe ser un archivo de código fuente, un espacio de nombres, una interfaz, módulo, clase o estructura; no puede ser un procedimiento.

Puede utilizar el modificador Friend junto con el modificador Protected (Visual Basic) en la misma declaración. Esta combinación consulta tanto acceso de Friend y acceso protegido a los elementos declarados, por lo que son accesibles desde cualquier parte del mismo ensamblado, su propia clase, y clases derivadas. Sólo puede especificar Protected Friend en miembros de clases.

Para una comparación de Friend y los otros modificadores de acceso, vea Niveles de acceso en Visual Basic.

Nota

Puede especificar que otro ensamblado es un ensamblado de confianza, que permite tener acceso a todos los tipos y miembros que están marcadas como Friend.Para obtener más información, vea Ensamblados de confianza (C# y Visual Basic).

Ejemplo

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