Событие My.Application.NetworkAvailabilityChanged

Обновлен: Ноябрь 2007

Возникает при изменении статуса доступности сети.

' Usage
Public Sub Me_NetworkAvailabilityChanged( _
   ByVal sender As Object, _
   ByVal e As NetworkAvailableEventArgs _
) Handles Me.NetworkAvailabilityChanged
End Sub
' Declaration
Public Event NetworkAvailabilityChanged( _
   ByVal sender As Object, _
   ByVal e As NetworkAvailableEventArgs _
)

Параметры

• sender
  Обязательный параметр. Объект Object, который вызвал событие.

• e
  Обязательный параметр. Объект NetworkAvailableEventArgs, содержащий информацию о доступности сети.

Заметки

Приложение вызывает событие NetworkAvailabilityChanged при каждом изменении доступности сети. Можно использовать свойство IsNetworkAvailable параметра e для получения нового состояния сетевого подключения. Свойство My.Computer.Network.IsAvailable позволяет получить текущее состояние сетевого подключения.

Это событие вызывается для основного потока приложения с другими событиями интерфейса пользователя. Это позволяет обработчику событий получить доступ напрямую к пользовательскому интерфейсу приложения. Однако, если приложение занято обработкой другого события пользовательского интерфейса при возникновении этого события, оно не будет обработано до тех пор, пока другой обработчик событий не завершит работу или вызовет Метод My.Application.DoEvents.

Событие My.Computer.Network.NetworkAvailabilityChanged предоставляет такую же функциональность, как это событие но доступно для всех типов приложений.

Код для обработчика событий NetworkAvailabilityChanged хранится в файле ApplicationEvents.vb, который скрыт по умолчанию.

Для доступа к окну редактора кода для событий приложения

1. Выберите проект в Обозревателе решений. В меню Проект выберите команду Свойства.

2. Перейдите на вкладку Приложение.

3. Нажмите кнопку Просмотреть события приложения, чтобы открыть редактор кода.

   Дополнительные сведения см. в разделе Практическое руководство. Обработка событий приложения (Visual Basic).

Примечание.
Многие сетевые концентраторы обеспечивают сетевое подключение даже в том случае, если концентратор отключен от сети большего размера. Следовательно, для проводных подключений, данное событие указывает изменение статуса связи между компьютером и концентратором.

Примечание.
Событие NetworkAvailabilityChanged не вызывается приложением, когда оно запущено в Windows 95 и Windows 98, или запущено без прав администратора в Windows 2000. Если приложение должно выполняться на этих платформах, используйте Свойство My.Computer.Network.IsAvailable для проверки доступности сети.

Пример

В этом примере вызывается метод SetConnectionStatus класса по умолчанию Form1 при изменении доступности сети.

Необходимо ввести код в окне редактора кода для событий приложения. Чтобы открыть это окно, следуйте инструкциям из главы "Примечания" в этом разделе.

Private Sub MyApplication_NetworkAvailabilityChanged( _
    ByVal sender As Object, _
    ByVal e As Microsoft.VisualBasic.Devices.NetworkAvailableEventArgs _
) Handles Me.NetworkAvailabilityChanged
    My.Forms.Form1.SetConnectionStatus(e.IsNetworkAvailable)
End Sub

Компиляция кода

Проект должен иметь форму с именем Form1. Он должен иметь метод с именем SetConnectionStatus, принимающий параметр Boolean.

Требования

Пространство имен:Microsoft.VisualBasic.ApplicationServices

Класс:WindowsFormsApplicationBase

**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта	Доступность
Приложение Windows	Да
Библиотека классов	Нет
Консольное приложение	Нет
Библиотека элементов управления Windows	Нет
Библиотека веб-элементов управления	Нет
Служба Windows	Нет
Веб-узел	Нет

Разрешения

Разрешения не требуются.

См. также

Ссылки

Объект My.Application

Объект My.Forms

Событие My.Computer.Network.NetworkAvailabilityChanged

Microsoft.VisualBasic.Devices.NetworkAvailableEventArgs