Friend (Visual Basic)
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
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
Règles
Contexte de déclaration. Vous pouvez utiliser le mot clé Friend seulement au niveau du module, de l'interface ou de l'espace de noms. Cela signifie que le contexte de déclaration pour un élément Friend doit être un fichier source, un espace de noms, une interface, un module, une classe ou une structure, et ne peut pas être une procédure.
Modificateurs combinés. Vous pouvez utiliser le modificateur Friend conjointement avec le modificateur Protected (Visual Basic) dans la même déclaration. Dans la mesure où cette combinaison confère à la fois l'accès ami et l'accès protégé aux éléments déclarés, ces derniers sont accessibles à partir du même assembly, de leur propre classe et de classes dérivées quelconques. Vous pouvez spécifier Protected Friend uniquement sur les membres d'une classe.
Comportement
Niveau d'accès. Tout le code d'un contexte de déclaration peut accéder à ses éléments. 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 ami n'est pas un sur-ensemble ou sous-ensemble d'accès protégé.
Modificateurs d'accès. Les mots clés qui spécifient le niveau d'accès portent le nom de modificateurs d'accès. Pour obtenir une comparaison entre les modificateurs d'accès, consultez Niveaux d'accès dans Visual Basic.
Quand utiliser Friend
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, il se peut que vous souhaitiez les rendre inaccessibles par leur code à l'extérieur de l'assembly, par exemple si l'application est propriétaire. Si vous souhaitez limiter l'accès à un élément de cette manière, vous pouvez le déclarer avec Friend.
L'accès ami est souvent le niveau par défaut pour les éléments de programmation d'une application. Notez que le niveau d'accès d'une interface, d'un module, d'une classe, ou d'une structure prend par défaut la valeur Friend si vous ne le déclarez pas.
Le modificateur Friend peut être utilisé dans les contextes suivants :
Voir aussi
Référence
Concepts
Niveaux d'accès dans Visual Basic