共用方式為


My.Computer.Network.Ping 方法

更新:2007 年 11 月

Ping 指定的伺服器。

 ' Usage Dim value As Boolean = My.Computer.Network.Ping(hostNameOrAddress) Dim value As Boolean = My.Computer.Network.Ping(address) Dim value As Boolean = My.Computer.Network.Ping(hostNameOrAddress ,timeout) Dim value As Boolean = My.Computer.Network.Ping(address ,timeout) ' Declaration Public Function Ping( _    ByVal hostNameOrAddress As String _ ) As Boolean ' -or- Public Function Ping( _    ByVal address As System.Uri _ ) As Boolean ' -or- Public Function Ping( _    ByVal hostNameOrAddress As String, _    ByVal timeout As Integer _ ) As Boolean ' -or- Public Function Ping( _    ByVal address As System.Uri, _    ByVal timeout As Integer _ ) As Boolean

參數

  • hostNameOrAddress
    String。要 Ping 之伺服器的 URL、電腦名稱或 IP 編號。必要項。

  • address
    Uri。要 Ping 之伺服器的 URI。必要項。

  • timeout
    Int32。聯繫目的端的時間臨界值 (以毫秒為單位)。預設值為 500。必要項。

傳回值

Boolean 指出作業是否順利完成。

例外狀況

下列條件可能造成擲回例外狀況:

備註

Ping 方法不是判斷遠端電腦可用性的保全方法:可能已關閉目標電腦上的 Ping 通訊埠,或者防火牆或路由器已封鎖 Ping 要求。

傳遞至 Ping 方法的位址必須可使用 DNS 解析,且之前不能帶有 "http://"。

工作

下表列出包含 My.Computer.Network.Ping 方法的工作範例。

若要

請參閱

判斷可使用遠端電腦或主機

HOW TO:在 Visual Basic 中判斷遠端電腦是否可用

範例

這個範例藉由判斷 Ping 方法是否傳回 True,報告是否可以 Ping 伺服器。

If My.Computer.Network.Ping("198.01.01.01") Then
   MsgBox("Server pinged successfully.")
Else
   MsgBox("Ping request timed out.")
End If

將 "198.01.01.01" 取代為要進行 Ping 的 IP 位址、URL 或伺服器電腦名稱。

這個範例藉由判斷 Ping 方法是否傳回 True,報告是否可以 Ping 伺服器,並指定 1000 毫秒的逾時間隔。

If My.Computer.Network.Ping("www.cohowinery.com",1000) Then
   MsgBox("Server pinged successfully.")
Else
   MsgBox("Ping request timed out.")
End If

將 "www.cohowinery.com" 取代為要進行 Ping 的 IP 位址、URL 或伺服器電腦名稱。

需求

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

類別︰Network

組件:Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)

依專案類型的可用性

專案類型

是否可用

Windows 應用程式

類別庫

主控台應用程式

Windows 控制項程式庫

Web 控制項程式庫

Windows 服務

網站

使用權限

下列使用權限可能為必要:

使用權限

描述

FileIOPermission

控制存取檔案和資料夾的功能。關聯的列舉型別:Unrestricted

SecurityPermission

描述套用至程式碼的一組安全性權限。關聯的列舉型別:ControlPrincipal

WebPermission

控制存取 HTTP 網際網路資源的權限。關聯的列舉型別:Unrestricted

SocketPermission

控制在傳輸位址上建立或接受連接的權限。關聯的列舉型別:Unrestricted

PerformanceCounterPermission

控制 Windows NT 效能計數器元件的存取。關聯的列舉型別:Unrestricted

NetworkInformationPermission

控制本機電腦之網路資訊和傳輸統計資料的存取權。關聯的列舉型別:Ping

如需詳細資訊,請參閱程式碼存取安全性要求使用權限

請參閱

參考

My.Computer.Network 物件

System.Uri

Network.Ping