ID do artigo: 828993 - Última revisão: quinta-feira, 19 de abril de 2007 - Revisão: 1.3

Como efetuar ping no endereço IP usando soquetes no Visual Basic .NET

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que está a utilizar. Foi desactivado o conteúdo do artigo, que pode não ser relevante para si.

Nesta página

Expandir tudo | Recolher tudo

Sumário

Este artigo passo a passo descreve como usar soquetes no Microsoft Visual Basic .NET para efetuar ping um endereço IP (Internet Protocol). A PING comando usa o ICMP (Internet Control Message Protocol) para testar uma conexão de rede. O tempo de resposta para efetuar ping um endereço IP específico é calculado e exibido. Este artigo usa a API de System.NET.Sockets do Visual Basic .NET para efetuar ping um endereço IP.

Requisitos

Este artigo pressupõe que você esteja familiarizado com os seguintes tópicos:
  • Programação com o Visual Basic .NET
  • Soquetes
A lista a seguir descreve o hardware recomendado, software, infra-estrutura de rede e service packs que você precisa:
  • Microsoft Windows 2000, Microsoft Windows XP ou Microsoft Windows Server 2003
  • Microsoft Visual Basic .NET

Declarar uma estrutura de pacotes ICMP

ICMP oferece suporte a pacotes que contêm mensagens de erro, mensagens de controle e mensagens informativas. A PING comando usa o ICMP para testar uma conexão de rede. Use o seguinte código para declarar a estrutura de um pacote ICMP e declara um método para calcular o número total de bytes em um pacote:
   Structure IcmpPacket
#Region "PUBLIC MEMBER VARIABLES"
      Dim type_message As Byte                ' Type of message.
      Dim subCode_type As Byte                ' Type of sub-code.
      Dim complement_checkSum As UInt16       ' One's complement checksum for the structure.
      Dim identifier As UInt16                ' Identifier.
      Dim sequenceNumber As UInt16            ' Sequence number.
      Dim data() As Byte                      ' Data.
#End Region


#Region "PUBLIC MEMBER METHODS"
      Public Sub Initialize(ByVal type As Byte, ByVal subCode As Byte, ByVal payload() As Byte)
         Dim index As Integer
         Dim buffer_icmpPacket() As Byte
         Dim cksumBuffer() As UInt16
         Dim icmpHeaderBufferIndex As Int32 = 0
         Me.type_message = type
         Me.subCode_type = subCode
         complement_checkSum = UInt16.Parse("0")
         identifier = UInt16.Parse("45")
         sequenceNumber = UInt16.Parse("0")
         Data = payload

         ' Declare a variable to store the total packet size.
         ' Call the Serialize method to count the total number of bytes in the packet.
         buffer_icmpPacket = Serialize()

         ' Resize a UInt16 array to half the size of the packet.
         ReDim cksumBuffer((buffer_icmpPacket.Length() \ 2) - 1)

         ' Initialize the UInt16 array.
         For index = 0 To (cksumBuffer.Length() - 1)
            cksumBuffer(index) = BitConverter.ToUInt16(buffer_icmpPacket, icmpHeaderBufferIndex)
            icmpHeaderBufferIndex += 2
         Next index

         'Call a method that returns a checksum.
         complement_checkSum = MCheckSum.Calculate(cksumBuffer, cksumBuffer.Length())
      End Sub

      Public Function Size() As Integer
         Return (8 + Data.Length())
      End Function

      ' The Serialize method converts the packet to a byte array to calculate the total size.
      Public Function Serialize() As Byte()
         Dim b_seq() As Byte = BitConverter.GetBytes(sequenceNumber)
         Dim b_cksum() As Byte = BitConverter.GetBytes(complement_checkSum)
         Dim b_id() As Byte = BitConverter.GetBytes(identifier)
         Dim index As Int32 = 0
         Dim buffer() As Byte
         ReDim buffer(Size() - 1)

         ' Serialize the structure into the array.
         buffer(0) = type_message
         buffer(1) = subCode_type
         index += 2
         Array.Copy(b_cksum, 0, buffer, index, 2)
         index += 2
         Array.Copy(b_id, 0, buffer, index, 2)
         index += 2
         Array.Copy(b_seq, 0, buffer, index, 2)
         index += 2

         ' Copy the data.
         If (Data.Length() > 0) Then
            Array.Copy(Data, 0, buffer, index, Data.Length())
         End If
         Return buffer
      End Function
#End Region
   End Structure

Definir a classe CPing

A classe CPing contém métodos para aceitar o nome do host ou o IP endereço de um servidor como entrada, para efetuar ping no nome de host ou endereço IP e para exibir o tempo de resposta.
   ' The CPing class.
   Public Class CPing
#Region "MEMBER CONSTANTS"
      Private Const DEFAULT_TIMEOUT As Integer = 1000
      Private Const SOCKET_ERROR As Integer = -1
      Private Const PING_ERROR As Integer = -1
      Private Const ICMP_ECHO As Integer = 8
      Private Const DATA_SIZE As Integer = 32
      Private Const RECV_SIZE As Integer = 128
#End Region

#Region "MEMBER VARIABLES"
      Private _open As Boolean = False
      Private _initialized As Boolean
      Private _recvBuffer() As Byte
      Private _packet As IcmpPacket
      Private _hostName As String
      Private _server As EndPoint
      Private _local As EndPoint
      Private _socket As Socket

#End Region

#Region "CONSTRUCTORS & FINALIZER"
      Public Sub New(ByVal hostName As String)
         Me.HostName() = hostName
         ReDim _recvBuffer(RECV_SIZE - 1)
      End Sub

      Public Sub New()
         ' Set the default host name to the local host.
         Me.HostName() = Dns.GetHostName()
         ReDim _recvBuffer(RECV_SIZE - 1)
      End Sub

      Private Overloads Sub finalize()
         ' Make sure that you close the socket.
         Me.Close()
         Erase _recvBuffer
      End Sub
#End Region

#Region "MEMBER METHODS"
      ' Get and set the current host name.
      Public Property HostName() As String
         Get
            Return _hostName
         End Get
         Set(ByVal Value As String)
            _hostName = Value
            ' If the CPing object is already open, close it and then reopen it by using a new host name.
            If (_open) Then
               Me.Close()
               Me.Open()
            End If
         End Set
      End Property

      ' Get the state (open or closed).
      Public ReadOnly Property IsOpen() As Boolean
         Get
            Return _open
         End Get
      End Property

      ' Create a socket to host remote end points and local end points.
      Public Function Open() As Boolean
         Dim payload() As Byte

         If (Not _open) Then
            Try
               ' Initialize the packet.
               ReDim payload(DATA_SIZE)
               _packet.Initialize(ICMP_ECHO, 0, payload)

               ' Initialize an ICMP socket.
               _socket = New Socket(AddressFamily.InterNetwork, SocketType.Raw, ProtocolType.Icmp)

               ' Set the server end point.
               _server = New IPEndPoint(Dns.GetHostByName(_hostName).AddressList(0), 0)

               ' Set the receiving end point as your client computer.
               _local = New IPEndPoint(Dns.GetHostByName(Dns.GetHostName()).AddressList(0), 0)
               _open = True
            Catch
               Return False
            End Try
         End If
         Return True
      End Function

      ' Destroy the socket and the end points (if necessary).
      Public Function Close() As Boolean
         If (_open) Then
            _socket.Close()
            _socket = Nothing
            _server = Nothing
            _local = Nothing
            _open = False
         End If
         Return True
      End Function

      ' Perform a PING operation.
      Public Overloads Function Ping() As Integer
         Return Ping(DEFAULT_TIMEOUT)
      End Function

      ' The Ping method performs a PING operation.
      Public Overloads Function Ping(ByVal timeOutMilliSeconds As Integer) As Integer

         ' Initialize the time-out value.
         Dim timeOut As Integer = timeOutMilliSeconds + Environment.TickCount()

         ' Send the packet.
         If (SOCKET_ERROR = _socket.SendTo(_packet.Serialize(), _packet.Size(), 0, _server)) Then
            Return PING_ERROR
         End If

         ' Use the following loop to check the response time until you receive a time-out.
         Do
            ' Poll the read buffer every millisecond.
            ' If data exists, read the data and return the round-trip time.
            If (_socket.Poll(1000, SelectMode.SelectRead)) Then
               _socket.ReceiveFrom(_recvBuffer, RECV_SIZE, 0, _local)
               Return (timeOutMilliSeconds - (timeOut - Environment.TickCount()))
            ElseIf (Environment.TickCount() >= timeOut) Then
               Return PING_ERROR
            End If
         Loop While (True)
      End Function
#End Region
   End Class

Calcular o valor de soma de verificação

O código a seguir contém um método Calculate para calcular o valor de soma de verificação. Esse código também contém uniões que usa o método de cálculo .
#Region "MEMBER METHODS"
      <StructLayout(LayoutKind.Explicit)> _
                 Structure UNION_INT16
         <FieldOffset(0)> Dim lsb As Byte      ' Least significant byte
         <FieldOffset(1)> Dim msb As Byte      ' Most significant byte
         <FieldOffset(0)> Dim w16 As Short
      End Structure

      <StructLayout(LayoutKind.Explicit)> _
      Structure UNION_INT32
         <FieldOffset(0)> Dim lsw As UNION_INT16     ' Most significant word
         <FieldOffset(2)> Dim msw As UNION_INT16     ' Least significant word
         <FieldOffset(0)> Dim w32 As Integer
      End Structure

      ' The Calculate method calculates the checksum value.
      Public Function Calculate(ByRef buffer() As UInt16, ByVal size As Int32) As UInt16
         Dim counter As Int32 = 0
         Dim cksum32 As UNION_INT32
         Do While (size > 0)
            cksum32.w32 += Convert.ToInt32(buffer(counter))
            counter += 1
            size -= 1
         Loop

         cksum32.w32 = cksum32.msw.w16 + cksum32.lsw.w16 + cksum32.msw.w16
         Return Convert.ToUInt16(cksum32.lsw.w16 Xor &HFFFF)
      End Function
#End Region

Implementar a interface do usuário

O código a seguir implementa a interface do usuário. Esse código determina se o nome de host ou o IP endereço que o usuário digita está vazio, e em seguida, o alerta o usuário digite um nome de host ou endereço IP no formato especificado. Depois que o usuário digita um nome de host ou endereço IP, o aplicativo estabelece uma conexão de soquete para o endereço IP correspondente (se este endereço estiver na mesma rede) e, em seguida, o aplicativo envia um pacote de dados usando o ICMP. O aplicativo, em seguida, calcula o tempo gasto (em milissegundos) para enviar e receber o pacote de dados e, em seguida, o aplicativo exibe este valor. Se o nome do host ou o endereço IP não estiver na mesma rede ou se o usuário digita um endereço IP inválido ou um nome de host inválido, o aplicativo exibe uma mensagem.
Sub Main()
   Dim Packet As New ICMP_Packet.CPing()
   Dim retValue

   Console.WriteLine("Enter the IP address or the host name to ping: ")

   ' Accept a host name or an IP address.
   Packet.HostName = Trim(Console.ReadLine())

   ' Determine whether the user has typed only spaces instead of a host name or an IP address.
   If Packet.HostName = "" Then
      Console.WriteLine("Please enter an IP address (in the N.N.N.N format) or a host name")
   Else
      ' Determine whether you can establish a socket connection to the IP address.
      If Packet.Open Then
         ' Establish a socket connection, and then send a packet using ICMP.
         retValue = Packet.Ping
         If retValue <> -1 Then
            ' Display the response time in milliseconds.
            Console.WriteLine("Approximate response time : " & retValue)
         Else
            Console.WriteLine("Host Unreachable")
         End If
      Else
         Console.WriteLine("No host found")
      End If
      
      Packet.Close()

   End If

   Console.WriteLine("Press ENTER to quit.")
   Console.ReadLine()

End Sub

Criar um aplicativo de console

  1. Inicie o Microsoft Visual Studio NET..
  2. No menu arquivo , aponte para novo e, em seguida, clique em Project . A caixa de diálogo New Project é exibida.
  3. Em Project Types , clique em Projetos do Visual Basic .
  4. Em modelos , clique em Console Application .
  5. Na caixa nome , digite MyConsoleApplication .

    Observação MyConsoleApplication é um exemplo de Visual Basic .NET aplicativo.
  6. Na caixa Location , digite o local onde você deseja salvar o projeto MyConsoleApplication e, em seguida, clique em OK .

    Por padrão, o arquivo Module1.vb é criado.
  7. No arquivo Module1.vb, substitua o código existente com o código a seguir:
    Imports System.Net.Sockets
    Imports System.Net
    Imports System
    Imports System.Runtime.InteropServices
    
    Namespace ICMP_Packet
    
       ' Define the structure of an ICMP packet.
       ' This structure contains packet information.
       Structure IcmpPacket
    #Region "PUBLIC MEMBER VARIABLES"
          Dim type_message As Byte                ' type of message
          Dim subCode_type As Byte                ' type of sub-code
          Dim complement_checkSum As UInt16       ' one's complement checksum for the structure
          Dim identifier As UInt16                ' identifier
          Dim sequenceNumber As UInt16            ' sequence number  
          Dim data() As Byte                      ' data
    #End Region
    
    
    #Region "PUBLIC MEMBER METHODS"
          Public Sub Initialize(ByVal type As Byte, ByVal subCode As Byte, ByVal payload() As Byte)
             Dim index As Integer
             Dim buffer_icmpPacket() As Byte
             Dim cksumBuffer() As UInt16
             Dim icmpHeaderBufferIndex As Int32 = 0
             Me.type_message = type
             Me.subCode_type = subCode
             complement_checkSum = UInt16.Parse("0")
             identifier = UInt16.Parse("45")
             sequenceNumber = UInt16.Parse("0")
             Data = payload
    
             ' Declare a variable to store the total packet size.
             ' Call the Serialize method to count the total number of bytes in the packet.
             buffer_icmpPacket = Serialize()
    
             ' Resize a UInt16 array to half the size of the packet.
             ReDim cksumBuffer((buffer_icmpPacket.Length() \ 2) - 1)
    
             ' Initialize the UInt16 array.
             For index = 0 To (cksumBuffer.Length() - 1)
                cksumBuffer(index) = BitConverter.ToUInt16(buffer_icmpPacket, icmpHeaderBufferIndex)
                icmpHeaderBufferIndex += 2
             Next index
    
             'Call a method that returns a checksum.
             complement_checkSum = MCheckSum.Calculate(cksumBuffer, cksumBuffer.Length())
          End Sub
    
          Public Function Size() As Integer
             Return (8 + Data.Length())
          End Function
    
          ' The Serialize method converts the packet to a byte array to calculate the total size.
          Public Function Serialize() As Byte()
             Dim b_seq() As Byte = BitConverter.GetBytes(sequenceNumber)
             Dim b_cksum() As Byte = BitConverter.GetBytes(complement_checkSum)
             Dim b_id() As Byte = BitConverter.GetBytes(identifier)
             Dim index As Int32 = 0
             Dim buffer() As Byte
             ReDim buffer(Size() - 1)
    
             ' Serialize the structure into the array.
             buffer(0) = type_message
             buffer(1) = subCode_type
             index += 2
             Array.Copy(b_cksum, 0, buffer, index, 2)
             index += 2
             Array.Copy(b_id, 0, buffer, index, 2)
             index += 2
             Array.Copy(b_seq, 0, buffer, index, 2)
             index += 2
    
             ' Copy the data.
             If (Data.Length() > 0) Then
                Array.Copy(Data, 0, buffer, index, Data.Length())
             End If
             Return buffer
          End Function
    #End Region
       End Structure
    
       ' The CPing class.
       Public Class CPing
    #Region "MEMBER CONSTANTS"
          Private Const DEFAULT_TIMEOUT As Integer = 1000
          Private Const SOCKET_ERROR As Integer = -1
          Private Const PING_ERROR As Integer = -1
          Private Const ICMP_ECHO As Integer = 8
          Private Const DATA_SIZE As Integer = 32
          Private Const RECV_SIZE As Integer = 128
    #End Region
    
    #Region "MEMBER VARIABLES"
          Private _open As Boolean = False
          Private _initialized As Boolean
          Private _recvBuffer() As Byte
          Private _packet As IcmpPacket
          Private _hostName As String
          Private _server As EndPoint
          Private _local As EndPoint
          Private _socket As Socket
    
    #End Region
    
    #Region "CONSTRUCTORS & FINALIZER"
          Public Sub New(ByVal hostName As String)
             Me.HostName() = hostName
             ReDim _recvBuffer(RECV_SIZE - 1)
          End Sub
    
          Public Sub New()
             ' Set the default host name to the local host.
             Me.HostName() = Dns.GetHostName()
             ReDim _recvBuffer(RECV_SIZE - 1)
          End Sub
    
          Private Overloads Sub finalize()
             ' Ensure that you close the socket.
             Me.Close()
             Erase _recvBuffer
          End Sub
    #End Region
    
    #Region "MEMBER METHODS"
          ' Get and set the current host name.
          Public Property HostName() As String
             Get
                Return _hostName
             End Get
             Set(ByVal Value As String)
                _hostName = Value
                ' If the CPing object is already open, close it and then reopen it by using a new host name.
                If (_open) Then
                   Me.Close()
                   Me.Open()
                End If
             End Set
          End Property
    
          ' Get the state (open or closed).
          Public ReadOnly Property IsOpen() As Boolean
             Get
                Return _open
             End Get
          End Property
    
          ' Create a socket to host remote end points and local end points.
          Public Function Open() As Boolean
             Dim payload() As Byte
    
             If (Not _open) Then
                Try
                   ' Initialize the packet.
                   ReDim payload(DATA_SIZE)
                   _packet.Initialize(ICMP_ECHO, 0, payload)
    
                   ' Initialize an ICMP socket.
                   _socket = New Socket(AddressFamily.InterNetwork, SocketType.Raw, ProtocolType.Icmp)
    
                   ' Set the server end point.
                   _server = New IPEndPoint(Dns.GetHostByName(_hostName).AddressList(0), 0)
    
                   ' Set the receiving end point as your client computer.
                   _local = New IPEndPoint(Dns.GetHostByName(Dns.GetHostName()).AddressList(0), 0)
                   _open = True
                Catch
                   Return False
                End Try
             End If
             Return True
          End Function
    
          ' Destroy the socket and end points (if necessary).
          Public Function Close() As Boolean
             If (_open) Then
                _socket.Close()
                _socket = Nothing
                _server = Nothing
                _local = Nothing
                _open = False
             End If
             Return True
          End Function
    
          ' Perform a PING operation.
          Public Overloads Function Ping() As Integer
             Return Ping(DEFAULT_TIMEOUT)
          End Function
    
          ' The Ping method performs a PING operation.
          Public Overloads Function Ping(ByVal timeOutMilliSeconds As Integer) As Integer
    
             ' Initialize the time-out value.
             Dim timeOut As Integer = timeOutMilliSeconds + Environment.TickCount()
    
             ' Send the packet.
             If (SOCKET_ERROR = _socket.SendTo(_packet.Serialize(), _packet.Size(), 0, _server)) Then
                Return PING_ERROR
             End If
    
             ' Use the following loop to check the response time until you receive a time-out.
             Do
                ' Poll the read buffer every millisecond.
                ' If data exists, read the data and return the round-trip time.
                If (_socket.Poll(1000, SelectMode.SelectRead)) Then
                   _socket.ReceiveFrom(_recvBuffer, RECV_SIZE, 0, _local)
                   Return (timeOutMilliSeconds - (timeOut - Environment.TickCount()))
                ElseIf (Environment.TickCount() >= timeOut) Then
                   Return PING_ERROR
                End If
             Loop While (True)
          End Function
    #End Region
       End Class
    
       ' The MCheckSum module contains the static Calculate method.
       Module MCheckSum
    #Region "MEMBER METHODS"
          <StructLayout(LayoutKind.Explicit)> _
                     Structure UNION_INT16
             <FieldOffset(0)> Dim lsb As Byte      ' Least significant byte
             <FieldOffset(1)> Dim msb As Byte      ' Most significant byte
             <FieldOffset(0)> Dim w16 As Short
          End Structure
    
          <StructLayout(LayoutKind.Explicit)> _
          Structure UNION_INT32
             <FieldOffset(0)> Dim lsw As UNION_INT16     ' Most significant word
             <FieldOffset(2)> Dim msw As UNION_INT16     ' Least significant word
             <FieldOffset(0)> Dim w32 As Integer
          End Structure
    
          ' The Calculate method calculates the checksum value.
          Public Function Calculate(ByRef buffer() As UInt16, ByVal size As Int32) As UInt16
             Dim counter As Int32 = 0
             Dim cksum32 As UNION_INT32
             Do While (size > 0)
                cksum32.w32 += Convert.ToInt32(buffer(counter))
                counter += 1
                size -= 1
             Loop
    
             cksum32.w32 = cksum32.msw.w16 + cksum32.lsw.w16 + cksum32.msw.w16
             Return Convert.ToUInt16(cksum32.lsw.w16 Xor &HFFFF)
          End Function
    #End Region
    
          Sub Main()
             Dim Packet As New ICMP_Packet.CPing()
             Dim retValue
    
             Console.WriteLine("Enter the IP address or the host name to ping: ")
    
             ' Accept a host name or an IP address.
             Packet.HostName = Trim(Console.ReadLine())
    
             ' Determine whether the user has typed only spaces instead of a host name or an IP address.
             If Packet.HostName = "" Then
                Console.WriteLine("Please enter an IP address (in the N.N.N.N format) or a host name")
             Else
                ' Determine whether you can establish a socket connection to the IP address.
                If Packet.Open Then
                   ' Establish a socket connection, and then send a packet by using ICMP.
                   retValue = Packet.Ping
                   If retValue <> -1 Then
                      ' Display the response time in milliseconds.
                      Console.WriteLine("Approximate response time : " & retValue)
                   Else
                      Console.WriteLine("Host Unreachable")
                   End If
                Else
                   Console.WriteLine("No host found")
                End If
                
                Packet.Close()
    
             End If
    
             Console.WriteLine("Press ENTER to quit.")
             Console.ReadLine()
    
          End Sub
       End Module
    
    End Namespace
  8. No Solution Explorer, clique em projeto MyConsoleApplication .
  9. No menu Project , clique em Propriedades .
  10. Em Páginas de propriedade MyConsoleApplication caixa de diálogo, selecione Sub Main do inicialização objeto lista drop-down caixa e, em seguida, clique em OK .
  11. No menu Debug , clique em Iniciar .
  12. No prompt de comando que aparece, digite um nome de host ou endereço IP e, em seguida, pressione ENTER.

Referências

Para obter mais informações, visite os seguintes sites do Microsoft Developer Network (MSDN) da:
http://msdn2.microsoft.com/en-us/library/system.net.sockets(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/system.net.sockets(vs.71).aspx)

http://msdn2.microsoft.com/en-us/library/b6xa24z5(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/b6xa24z5(vs.71).aspx)

http://msdn2.microsoft.com/en-us/library/system.net.sockets.socket(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/system.net.sockets.socket(vs.71).aspx)
Para obter informações adicionais, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
300197  (http://support.microsoft.com/kb/300197/ ) COMO: executar ping em um endereço IP com o Visual Basic usando ICMP

A informação contida neste artigo aplica-se a:
  • Microsoft Visual Basic .NET 2003 Standard Edition
  • Microsoft Visual Basic .NET 2002 Standard Edition
Palavras-chave: 
kbmt kbnetwork kbhowtomaster kbwinsock KB828993 KbMtpt
Tradução automáticaTradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 828993  (http://support.microsoft.com/kb/828993/en-us/ )