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 指出作業是否順利完成。
例外狀況
下列條件可能造成擲回例外狀況:
沒有可用的網路連線 (InvalidOperationException)。
URL 無效 (PingException)。
備註
Ping 方法不是判斷遠端電腦可用性的保全方法:可能已關閉目標電腦上的 Ping 通訊埠,或者防火牆或路由器已封鎖 Ping 要求。
傳遞至 Ping 方法的位址必須可使用 DNS 解析,且之前不能帶有 "http://"。
工作
下表列出包含 My.Computer.Network.Ping 方法的工作範例。
若要 |
請參閱 |
---|---|
判斷可使用遠端電腦或主機 |
範例
這個範例藉由判斷 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 服務 |
是 |
網站 |
是 |
使用權限
下列使用權限可能為必要:
使用權限 |
描述 |
---|---|
控制存取檔案和資料夾的功能。關聯的列舉型別:Unrestricted。 |
|
描述套用至程式碼的一組安全性權限。關聯的列舉型別:ControlPrincipal。 |
|
控制存取 HTTP 網際網路資源的權限。關聯的列舉型別:Unrestricted。 |
|
控制在傳輸位址上建立或接受連接的權限。關聯的列舉型別:Unrestricted。 |
|
控制 Windows NT 效能計數器元件的存取。關聯的列舉型別:Unrestricted。 |
|
控制本機電腦之網路資訊和傳輸統計資料的存取權。關聯的列舉型別:Ping。 |