Friend (Visual Basic)

Article
03/04/2013

Spécifie qu'un ou plusieurs éléments de programmation déclarés sont accessibles uniquement à partir de l'assembly qui contient leur déclaration.

Notes

Dans de nombreux cas, vous souhaitez que les éléments de programmation, tels que les classes et les structures, soient utilisés par l'assembly entier, pas uniquement par le composant qui les déclare.Toutefois, vous ne pouvez pas les utiliser pour être accessible par le code en dehors de l'assembly (par exemple, si l'application est propriétaire).Si vous souhaitez limiter l'accès à un élément de cette façon, vous pouvez la déclarer à l'aide de le modificateur d' Friend .

Le code d'autres classes, structures et modules compilés dans le même assembly peut accéder à tous les éléments Friend de cet assembly.

l'accès d'Friend est souvent le niveau par défaut pour les éléments de programmation d'une application, et Friend est le niveau d'accès par défaut d'une interface, d'un module, d'une classe, ou d'une structure.

Vous pouvez utiliser Friend uniquement au module, à l'interface, ou au niveau de l'espace de noms.Par conséquent, le contexte de déclaration pour un élément d' Friend doit être un fichier source, espace de noms, une interface, d'un module, une classe, ou une structure ; il ne peut pas être une procédure.

Vous pouvez utiliser le modificateur Friend conjointement avec le modificateur Protected (Visual Basic) dans la même déclaration.Cette combinaison confère accès d' Friend et accès protégé sur les éléments déclarés ; ils sont accessibles n'importe où dans le même assembly, de leur propre classe, et des classes dérivées.Vous pouvez spécifier Protected Friend uniquement sur les membres d'une classe.

Pour une comparaison d' Friend et les autres modificateurs d'accès, consultez l' Niveaux d'accès dans Visual Basic.

[!REMARQUE]

Vous pouvez spécifier qu'un autre assembly est un assembly friend, qui lui permet d'accéder à tous les types et membres marqués comme Friend.Pour plus d'informations, consultez Assemblys friend (C# et Visual Basic).

Exemple

La classe suivante utilise le modificateur Friend pour permettre à d'autres éléments de programmation du même assembly d'accéder à certains membres.

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