Friend (Visual Basic)

Article
09/12/2008

Mise à jour : novembre 2007

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

Règles

Contexte de déclaration. Vous pouvez utiliser 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 :

Class, instruction

Const, instruction

Declare, instruction

Delegate, instruction

Dim, instruction

Enum, instruction

Event, instruction

Function, instruction

Interface, instruction

Module, instruction

Property, instruction