My.Computer.Network.Ping 메서드

아티클
08/20/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
필수적 요소이며 String 형식입니다. ping을 실행하는 서버의 URL, 컴퓨터 이름 또는 IP 번호입니다.
address
Uri 형식으로 ping을 실행하는 서버의 URI입니다. 필수적 요소입니다.
timeout
Int32 형식으로 대상에 연결하기 위한 시간 임계값(밀리초)입니다. 기본값은 500이며 필수적 요소입니다.

반환 값

작업이 성공되었는지 여부를 나타내는 Boolean입니다.

예외

다음 조건에서 예외가 throw될 수 있습니다.

네트워크 연결을 사용할 수 없는 경우(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를 반환했는지 여부를 확인하여 서버에서 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로 바꿉니다.

요구 사항

네임스페이스:Microsoft.VisualBasic.Devices

클래스:Network

어셈블리: Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

프로젝트 형식별 사용 가능 여부

프로젝트 형식	사용 가능 여부
Windows 응용 프로그램	예
클래스 라이브러리	예
콘솔 응용 프로그램	예
Windows 컨트롤 라이브러리	예
웹 컨트롤 라이브러리	예
Windows 서비스	예
웹 사이트	예

권한

다음과 같은 사용 권한이 필요합니다.

권한	설명
FileIOPermission	파일 및 폴더에 대한 액세스 가능성을 제어합니다. 연관된 열거형: Unrestricted
SecurityPermission	코드에 적용된 보안 권한 집합을 설명합니다. 연관된 열거형: ControlPrincipal
WebPermission	HTTP 인터넷 리소스에 액세스할 수 있는 권한을 제어합니다. 연관된 열거형: Unrestricted
SocketPermission	전송 주소에 대해 연결을 만들거나 허용할 수 있는 권한을 제어합니다. 연관된 열거형: Unrestricted
PerformanceCounterPermission	Windows NT 성능 카운터 구성 요소에 대한 액세스를 제어합니다. 연관된 열거형: Unrestricted
NetworkInformationPermission	로컬 컴퓨터의 네트워크 정보 및 트래픽 통계에 대한 액세스를 제어합니다. 연관된 열거형: Ping

자세한 내용은 코드 액세스 보안 및 권한 요청을 참조하십시오.

참고 항목

참조

My.Computer.Network 개체

System.Uri

Network.Ping

다음을 통해 공유