Friend (Visual Basic)

 

Date de publication : août 2016

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

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.

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 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' Access Levels in Visual Basic.

System_CAPS_ICON_note.jpg 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.

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

Vous pouvez utiliser le modificateur d' Friend dans ces contextes :

Class, instruction

Const, instruction

Declare, instruction

Delegate, instruction

Dim, instruction

Enum, instruction

Event, instruction

Function, instruction

Interface, instruction

Module, instruction

Property, instruction

Structure, instruction

Sub, instruction

InternalsVisibleToAttribute
Public
Protected
Private
Access Levels in Visual Basic
Procedures
Structures
Objects and Classes

Afficher: