Friend (Visual Basic)

Статья
02/20/2013

Указывает на то, что один или несколько элементов доступны только из сборки, которая содержит их объявления.

Заметки

В большинстве случаев требуются элементы программирования, такие как классы и структуры, используемые всей сборкой, а не только компонентом, объявляющим их.Однако может потребоваться не их быть доступны кода извне сборки (например, если приложение собственническо).Если требуется ограничить доступ к элементу таким образом, можно объявить его с помощью модификатора Friend.

Код в других классах, структурах и модулях, которые компилируются к той же сборке, может иметь доступ ко всем элементам Friend в этой сборке.

метод доступа Friend часто оптимальный уровень программных элементов приложения и Friend уровень доступа по умолчанию интерфейса, модуля, класса или структуры.

Friend можно использовать только в модуле, интерфейса или уровне пространства имен.Поэтому контекст объявления элемента Friend должен быть файл источника, пространства имен, интерфейса, модуль, класс или структура; не может быть процедурой.

Можно использовать модификатор Friend вместе с модификатором Protected (Visual Basic) в одном объявлении.Это сочетание совещается оба метода доступа Friend и защищенный доступ на объявленных элементов, поэтому они доступны из любого места внутри одной и той же сборки, из своего класса и из производных классов.Можно указать Protected Friend только для элементов классов.

Для сравнения Friend и других модификаторов доступа см. в разделе Уровни доступа в Visual Basic.

Примечание
Можно указать, что другая сборка дружественной сборки, которая позволяет его, чтобы получить все типы и члены, которые помечены как Friend.Для получения дополнительной информации см. Дружественные сборки (C# и Visual Basic).

Пример

Следующий класс использует модификатор Friend, позволяющие другими элементами программирования в одной сборке получить доступ к определенным элементам.

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