My.Application.NetworkAvailabilityChanged 事件

發行項
08/21/2008

更新：2007 年 11 月

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

' 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 事件。您可以使用 e 參數的 IsNetworkAvailable 屬性，取得網路連接的新狀態。若要取得網路連接目前的狀態，請使用 My.Computer.Network.IsAvailable 屬性。

這個事件會在應用程式的主執行緒上，與其他使用者介面事件一起引發。這可讓事件處理常式直接存取應用程式的 UI。不過，如果在引發此事件時應用程式正忙著處理其他使用者介面事件，則必須等到其他事件處理常式完成或呼叫 My.Application.DoEvents 方法之後，才能處理這個事件。

My.Computer.Network.NetworkAvailabilityChanged 事件提供的功能和這個事件一樣，但可以適用於所有應用程式類型。

NetworkAvailabilityChanged 事件處理常式的程式碼儲存在 ApplicationEvents.vb 檔中，檔案預設為隱藏檔。

若要存取應用程式事件的程式碼編輯器視窗

在 [方案總管] 中選取專案。在 [專案] 功能表上按一下 [屬性]。
按一下 [應用程式] 索引標籤。
按一下 [檢視應用程式事件] 按鈕，開啟 [程式碼編輯器]。

如需詳細資訊，請參閱 HOW TO：處理應用程式事件 (Visual Basic)。

注意事項：
許多網路集線器將提供網路連接，即使從大型網路中斷連接集線器也一樣。因此若是有線連接，則這個事件會指出電腦和集線器之間的連接變更。

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

範例

這個範例會在網路可用性變更時，呼叫預設 Form1 類別的 SetConnectionStatus 方法。

您必須在應用程式事件的 [程式碼編輯器] 視窗中輸入程式碼。若要存取這個視窗，請依照此主題中註解章節的指示進行。

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