My.Computer.Network.NetworkAvailabilityChanged 事件

更新：2007 年 11 月

當網路可用性變更時發生。

 ' Usage Public Sub MyComputerNetwork_NetworkAvailabilityChanged( _    ByVal sender As Object, _    ByVal e As Devices.NetworkAvailableEventArgs _ ) End Sub Sub Handle_NetworkAvailabilityChanged()    AddHandler My.Computer.Network.NetworkAvailabilityChanged, _       AddressOf MyComputerNetwork_NetworkAvailabilityChanged End Sub ' Declaration Public Event NetworkAvailabilityChanged( _    ByVal sender As Object, _    ByVal e As Devices.NetworkAvailableEventArgs _ )

參數

• sender
  必要項。引發事件的 Object。

• e
  必要項。包含網路可用性相關資訊的 NetworkAvailableEventArgs 物件。

備註

每次網路可用性變更時，應用程式就會引發 NetworkAvailabilityChanged 事件。您可以使用 e 參數的 IsNetworkAvailable 屬性，取得網路連接的新狀態。若要取得網路連接的目前狀態，請使用 My.Computer.Network.IsAvailable 屬性。

在 Windows Form 應用程式中，這個事件會在應用程式的主執行緒上與其他使用者介面事件一起引發。這可以讓事件處理常式直接存取應用程式的使用者介面。不過，如果引發這個事件時，應用程式正忙於處理另一個使用者介面事件，則直到其他事件處理常式完成或呼叫 My.Application.DoEvents 方法之前，都無法處理這個事件。

您不能使用 Handles 陳述式，處理 NetworkAvailabilityChanged 事件，而必須使用 AddHandler 陳述式。

在 Windows Form 應用程式中，My.Application 物件會公開 (Expose) 與這個事件提供相同功能的 NetworkAvailabilityChanged 事件，但是您可以利用 Handles 陳述式處理它。如需詳細資訊，請參閱 My.Application.NetworkAvailabilityChanged 事件。

注意事項：
即使集線器與大型網路中斷連接，仍有許多網路集線器會提供網路連接。因此，對於有線連接而言，這個事件表示電腦與集線器之間的連接發生變更。

注意事項：
在 Windows 95 和 Windows 98 上執行的應用程式，或非系統管理員在 Windows 2000 上執行的應用程式不會引發 NetworkAvailabilityChanged 事件。如果您的應用程式可以在這些平台上執行，請使用 My.Computer.Network.IsAvailable 屬性檢查網路可用性。

範例

這個範例會使用 My.Computer.Network.NetworkAvailabilityChanged 事件，更新表單或控制項的使用者介面。

Private Sub DisplayAvailability(ByVal available As Boolean)
    Label1.Text = available.ToString
End Sub

Private Sub MyComputerNetwork_NetworkAvailabilityChanged( _
    ByVal sender As Object, _
    ByVal e As Devices.NetworkAvailableEventArgs)

    DisplayAvailability(e.IsNetworkAvailable)
End Sub

Private Sub Handle_NetworkAvailabilityChanged()
    AddHandler My.Computer.Network.NetworkAvailabilityChanged, _
       AddressOf MyComputerNetwork_NetworkAvailabilityChanged
    DisplayAvailability(My.Computer.Network.IsAvailable)
End Sub

這個程式碼應該位於具有 Label (名為 Label1) 的表單或控制項中。您必須呼叫 Handle_NetworkAvailabilityChanged 方法來初始化標籤以及連結事件處理常式。

需求

命名空間 (Namespace)︰Microsoft.VisualBasic.Devices

類別︰Network

組件 (Assembly)：Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)

依專案類型的可用性

專案類型	是否可用
Windows 應用程式	是
類別庫	是
主控台應用程式	是
Windows 控制項程式庫	是
Web 控制項程式庫	是
Windows 服務	是
網站	是

使用權限

不需要使用權限。

請參閱

參考

My.Computer.Network 物件

My.Application.NetworkAvailabilityChanged 事件

Microsoft.VisualBasic.Devices.NetworkAvailableEventArgs