My.Computer.Network.Ping メソッド

[アーティクル]
08/16/2008

更新 : 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
ping を実行するサーバーの URL、コンピュータ名、または IP 番号を指定する String です。必ず指定します。
address
ping を実行するサーバーの URI を指定する Uri です。必ず指定します。
timeout
目的のサーバーにコンタクトするまでの時間のしきい値をミリ秒で指定する Int32 です。既定値は 500 です。必ず指定します。

戻り値

処理が成功したかどうかを示す Boolean です。

例外

例外がスローされる可能性のある状態を次に示します。

ネットワーク接続が利用できない場合 (InvalidOperationException)。
URL が有効でない場合 (PingException)。

解説

Ping メソッドはリモートコンピュータが利用可能かどうかを調べるためのフェールセーフなメソッドではありません。ターゲットコンピュータの ping ポートがオフになっている場合もあれば、ping 要求がファイアウォールやルーターによってブロックされている場合もあります。

Ping メソッドに渡すアドレスは、DNS による解決が可能であることが必要です。また、先頭に "http://" を付けることはできません。

処理手順

My.Computer.Network.Ping メソッドに関連するタスクの例を次の表に示します。

目的	参照項目
リモートコンピュータまたはリモートホストが利用可能かどうかを調べる	方法 : 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 を返すかどうかを調べ、タイムアウト時間に 1000 ミリ秒を指定することによって、サーバーが ping 可能かどうかを報告します。

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、またはコンピュータ名に変更してください。

必要条件

名前空間 : Microsoft.VisualBasic.Devices

クラス : Network

アセンブリ : Microsoft Visual Basic ランタイム (Microsoft.VisualBasic.dll 内)

使用可能なプロジェクトの種類

プロジェクトの種類	使用可/不可
Windows アプリケーション	可
クラスライブラリ	可
コンソールアプリケーション	可
Windows コントロールライブラリ	可
Web コントロールライブラリ	可
Windows サービス	可
Web サイト	可

アクセス許可

次のアクセス許可が必要になる可能性があります。

アクセス許可	説明
FileIOPermission	ファイルとフォルダへのアクセス許可を制御します。関連する列挙値 : Unrestricted。
SecurityPermission	コードに適用されたセキュリティアクセス許可のセットを記述します。関連する列挙値 : ControlPrincipal。
WebPermission	HTTP インターネットリソースにアクセスするための権限を制御します。関連する列挙値 : Unrestricted。
SocketPermission	トランスポートアドレスでの接続の確立と承認のための権限を制御します。関連する列挙値 : Unrestricted。
PerformanceCounterPermission	Windows NT パフォーマンスカウンタコンポーネントへのアクセスを制御します。関連する列挙値 : Unrestricted。
NetworkInformationPermission	ローカルコンピュータのネットワーク情報およびトラフィックの統計情報へのアクセスを制御します。関連する列挙値 : Ping。

詳細については、「コードアクセスセキュリティ」および「アクセス許可の要求」を参照してください。

参照

My.Computer.Network オブジェクト

System.Uri

Network.Ping

次の方法で共有