Ping.Send Ping.Send Ping.Send Ping.Send Method

Definición

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) a un equipo remoto y recibir un mensaje de respuesta de eco ICMP correspondiente del equipo remoto.Attempts to send an Internet Control Message Protocol (ICMP) echo message to a remote computer and receive a corresponding ICMP echo reply message from the remote computer.

Sobrecargas

Send(String, Int32, Byte[], PingOptions) Send(String, Int32, Byte[], PingOptions) Send(String, Int32, Byte[], PingOptions) Send(String, Int32, Byte[], PingOptions)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado y recibir el correspondiente mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y controlar los valores de Período de vida y fragmentación para el paquete ICMP.This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP packet.

Send(IPAddress, Int32, Byte[], PingOptions) Send(IPAddress, Int32, Byte[], PingOptions) Send(IPAddress, Int32, Byte[], PingOptions) Send(IPAddress, Int32, Byte[], PingOptions)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo con la IPAddress especificada y recibir un mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress and receive a corresponding ICMP echo reply message from that computer. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y controlar los valores de Período de vida y fragmentación para el paquete del mensaje de eco ICMP.This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP echo message packet.

Send(String, Int32, Byte[]) Send(String, Int32, Byte[]) Send(String, Int32, Byte[]) Send(String, Int32, Byte[])

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado y recibir el correspondiente mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.This overload allows you to specify a time-out value for the operation.

Send(IPAddress, Int32, Byte[]) Send(IPAddress, Int32, Byte[]) Send(IPAddress, Int32, Byte[]) Send(IPAddress, Int32, Byte[])

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene la IPAddress especificada y recibir el correspondiente mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.This overload allows you to specify a time-out value for the operation.

Send(String, Int32) Send(String, Int32) Send(String, Int32) Send(String, Int32)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) al equipo especificado y recibir un mensaje de respuesta de eco ICMP correspondiente de dicho equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Este método permite especificar un valor de tiempo de espera para la operación.This method allows you to specify a time-out value for the operation.

Send(IPAddress, Int32) Send(IPAddress, Int32) Send(IPAddress, Int32) Send(IPAddress, Int32)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene la IPAddress especificada y recibir el correspondiente mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer. Este método permite especificar un valor de tiempo de espera para la operación.This method allows you to specify a time-out value for the operation.

Send(String) Send(String) Send(String) Send(String)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) al equipo especificado y recibir un mensaje de respuesta de eco ICMP correspondiente de dicho equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer.

Send(IPAddress) Send(IPAddress) Send(IPAddress) Send(IPAddress)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) al equipo que tiene la IPAddress especificada y recibir el correspondiente mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer.

Comentarios

La dirección IP devuelta por cualquiera de los Send sobrecargas pueden originarse en un equipo remoto malintencionado.The IP address returned by any of the Send overloads can originate from a malicious remote computer. No se conectan al equipo remoto con este.Do not connect to the remote computer using this. Usar DNS para determinar la dirección IP de la máquina a la que desea conectarse.Use DNS to determine the IP address of the machine to which you want to connect.

Send(String, Int32, Byte[], PingOptions) Send(String, Int32, Byte[], PingOptions) Send(String, Int32, Byte[], PingOptions) Send(String, Int32, Byte[], PingOptions)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado y recibir el correspondiente mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y controlar los valores de Período de vida y fragmentación para el paquete ICMP.This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP packet.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);
public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);
member this.Send : string * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply
Public Function Send (hostNameOrAddress As String, timeout As Integer, buffer As Byte(), options As PingOptions) As PingReply

Parámetros

hostNameOrAddress
String String String String

String que identifica el equipo de destino para el mensaje de eco ICMP.A String that identifies the computer that is the destination for the ICMP echo message. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.The value specified for this parameter can be a host name or a string representation of an IP address.

timeout
Int32 Int32 Int32 Int32

Valor Int32 que especifica el número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

buffer
Byte[]

Matriz de Byte que contiene los datos que se envían con el mensaje de eco ICMP y se devuelven en el mensaje de respuesta de eco ICMP.A Byte array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. La matriz no puede contener más de 65.500 bytes.The array cannot contain more than 65,500 bytes.

options
PingOptions PingOptions PingOptions PingOptions

Objeto PingOptions que se usa para controlar los valores de Período de vida y fragmentación del paquete de mensaje de eco ICMP.A PingOptions object used to control fragmentation and Time-to-Live values for the ICMP echo message packet.

Devoluciones

Un objeto PingReply que proporciona información sobre el mensaje de respuesta de eco ICMP, si se recibió alguno, o indica el motivo del error, si no se recibió ningún mensaje.A PingReply object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

Excepciones

El tamaño de buffer es superior a 65.500 bytes.The size of buffer exceeds 65500 bytes.

El valor de hostNameOrAddress es null o una cadena de longitud cero.hostNameOrAddress is null or is a zero length string.

O bien-or- El valor de buffer es null, o el tamaño de buffer es superior a 65.500 bytes.buffer is null, or the buffer size is greater than 65500 bytes.

address es una dirección IPv6 y el equipo local está ejecutando un sistema operativo anterior a Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Se ha producido una excepción al enviar o recibir los mensajes ICMP.An exception was thrown while sending or receiving the ICMP messages. Para conocer la excepción exacta que se produjo, vea la excepción interna.See the inner exception for the exact exception that was thrown.

Este objeto se ha eliminado.This object has been disposed.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.The following code example demonstrates how to call this method.

void ComplexPing()
{
   Ping ^ pingSender = gcnew Ping;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   
   // Set options for transmission:
   // The data can go through 64 gateways or routers
   // before it is destroyed, and the data packet
   // cannot be fragmented.
   PingOptions ^ options = gcnew PingOptions( 64,true );
   
   // Send the request.
   PingReply ^ reply = pingSender->Send( "www.contoso.com", timeout, buffer, options );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}


public static void ComplexPing ()
{
    Ping pingSender = new Ping ();

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);

    // Send the request.
    PingReply reply = pingSender.Send ("www.contoso.com", timeout, buffer, options);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Comentarios

Si no se recibe el mensaje de respuesta de eco ICMP en el tiempo especificado por el timeout parámetro, el eco ICMP se produce un error y el Status propiedad está establecida en TimedOut.If the ICMP echo reply message is not received within the time specified by the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Nota

Al especificar un número muy reducido para timeout, puede recibir la respuesta de Ping aunque timeout milisegundos transcurridos.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Si el DontFragment propiedad es true y el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP.If the DontFragment property is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. Cuando esto sucede, el Status está establecido en PacketTooBig.When this happens, the Status is set to PacketTooBig.

Use el Ttl propiedad para especificar el número máximo de veces que se puede reenviar el mensaje de eco ICMP antes de llegar a su destino.Use the Ttl property to specify the maximum number of times the ICMP echo message can be forwarded before reaching its destination. Si el paquete no llega a su destino después de que se reenvían el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. Cuando esto sucede, el Status está establecido en TtlExpired.When this happens, the Status is set to TtlExpired.

Seguridad

NetworkInformationPermission
Para enviar un mensaje de eco ICMP.To send an ICMP echo message. Enumeración asociada: PingAssociated enumeration: Ping

Send(IPAddress, Int32, Byte[], PingOptions) Send(IPAddress, Int32, Byte[], PingOptions) Send(IPAddress, Int32, Byte[], PingOptions) Send(IPAddress, Int32, Byte[], PingOptions)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo con la IPAddress especificada y recibir un mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress and receive a corresponding ICMP echo reply message from that computer. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación y controlar los valores de Período de vida y fragmentación para el paquete del mensaje de eco ICMP.This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP echo message packet.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);
public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);
member this.Send : System.Net.IPAddress * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply
Public Function Send (address As IPAddress, timeout As Integer, buffer As Byte(), options As PingOptions) As PingReply

Parámetros

address
IPAddress IPAddress IPAddress IPAddress

IPAddress que identifica el equipo de destino para el mensaje de eco ICMP.An IPAddress that identifies the computer that is the destination for the ICMP echo message.

timeout
Int32 Int32 Int32 Int32

Valor Int32 que especifica el número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

buffer
Byte[]

Matriz de Byte que contiene los datos que se envían con el mensaje de eco ICMP y se devuelven en el mensaje de respuesta de eco ICMP.A Byte array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. La matriz no puede contener más de 65.500 bytes.The array cannot contain more than 65,500 bytes.

options
PingOptions PingOptions PingOptions PingOptions

Objeto PingOptions que se usa para controlar los valores de Período de vida y fragmentación del paquete de mensaje de eco ICMP.A PingOptions object used to control fragmentation and Time-to-Live values for the ICMP echo message packet.

Devoluciones

Un objeto PingReply que proporciona información sobre el mensaje de respuesta de eco ICMP, si se recibió alguno, o indica el motivo del error, si no se recibió ningún mensaje.A PingReply object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. El método devolverá PacketTooBig si el paquete supera la Unidad de transmisión máxima (MTU).The method will return PacketTooBig if the packet exceeds the Maximum Transmission Unit (MTU).

Excepciones

El tamaño de buffer es superior a 65.500 bytes.The size of buffer exceeds 65500 bytes.

address es null.address is null.

O bien-or- El valor de buffer es null, o el tamaño de buffer es superior a 65.500 bytes.buffer is null, or the buffer size is greater than 65500 bytes.

address es una dirección IPv6 y el equipo local está ejecutando un sistema operativo anterior a Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Se ha producido una excepción al enviar o recibir los mensajes ICMP.An exception was thrown while sending or receiving the ICMP messages. Para conocer la excepción exacta que se produjo, vea la excepción interna.See the inner exception for the exact exception that was thrown.

Este objeto se ha eliminado.This object has been disposed.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.The following code example demonstrates how to call this method.

void ComplexLocalPing()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   
   // Set options for transmission:
   // The data can go through 64 gateways or routers
   // before it is destroyed, and the data packet
   // cannot be fragmented.
   PingOptions ^ options = gcnew PingOptions( 64,true );
   PingReply ^ reply = pingSender->Send( address, timeout, buffer, options );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}


public static void ComplexLocalPing ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);
    PingReply reply = pingSender.Send (address, timeout, buffer, options);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Comentarios

Si no se recibe el mensaje de respuesta de eco ICMP en el tiempo especificado por el timeout parámetro, el eco ICMP se produce un error y el Status propiedad está establecida en TimedOut.If the ICMP echo reply message is not received within the time specified by the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Nota

Al especificar un número muy reducido para timeout, puede recibir la respuesta de Ping aunque timeout milisegundos transcurridos.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Si el DontFragment propiedad es true y el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP.If the DontFragment property is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. Cuando esto sucede, el Status está establecido en PacketTooBig.When this happens, the Status is set to PacketTooBig.

Use el Ttl propiedad para especificar el número máximo de veces que se puede reenviar el mensaje de eco ICMP antes de llegar a su destino.Use the Ttl property to specify the maximum number of times the ICMP echo message can be forwarded before reaching its destination. Si el paquete no llega a su destino después de que se reenvían el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. Cuando esto sucede, el Status está establecido en TtlExpired.When this happens, the Status is set to TtlExpired.

Seguridad

NetworkInformationPermission
Para enviar un mensaje de eco ICMP.To send an ICMP echo message. Enumeración asociada: PingAssociated enumeration: Ping

Send(String, Int32, Byte[]) Send(String, Int32, Byte[]) Send(String, Int32, Byte[]) Send(String, Int32, Byte[])

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo especificado y recibir el correspondiente mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.This overload allows you to specify a time-out value for the operation.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer);
public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout, byte[] buffer);
member this.Send : string * int * byte[] -> System.Net.NetworkInformation.PingReply
Public Function Send (hostNameOrAddress As String, timeout As Integer, buffer As Byte()) As PingReply

Parámetros

hostNameOrAddress
String String String String

String que identifica el equipo de destino para el mensaje de eco ICMP.A String that identifies the computer that is the destination for the ICMP echo message. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.The value specified for this parameter can be a host name or a string representation of an IP address.

timeout
Int32 Int32 Int32 Int32

Valor Int32 que especifica el número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

buffer
Byte[]

Matriz de Byte que contiene los datos que se envían con el mensaje de eco ICMP y se devuelven en el mensaje de respuesta de eco ICMP.A Byte array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. La matriz no puede contener más de 65.500 bytes.The array cannot contain more than 65,500 bytes.

Devoluciones

Un objeto PingReply que proporciona información sobre el mensaje de respuesta de eco ICMP, si se recibió alguno, o indica el motivo del error, si no se recibió ningún mensaje.A PingReply object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

Excepciones

El tamaño de buffer es superior a 65.500 bytes.The size of buffer exceeds 65500 bytes.

hostNameOrAddress es null o una cadena vacía ("").hostNameOrAddress is null or is an empty string ("").

O bien-or- El valor de buffer es null, o el tamaño de buffer es superior a 65.500 bytes.buffer is null, or the buffer size is greater than 65500 bytes.

Se ha producido una excepción al enviar o recibir los mensajes ICMP.An exception was thrown while sending or receiving the ICMP messages. Para conocer la excepción exacta que se produjo, vea la excepción interna.See the inner exception for the exact exception that was thrown.

Este objeto se ha eliminado.This object has been disposed.

Ejemplos

Para obtener un ejemplo que muestra cómo llamar a un Send sobrecarga, vea el Ping información general de clases.For an example that demonstrates how to call a Send overload, see the Ping class overview.

Comentarios

Si no se recibe el mensaje de respuesta de eco ICMP en el tiempo especificado en el timeout parámetro, el eco ICMP se produce un error y el Status propiedad está establecida en TimedOut.If the ICMP echo reply message is not received within the time specified in the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Nota

Al especificar un número muy reducido para timeout, puede recibir la respuesta de Ping aunque timeout milisegundos transcurridos.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Esta sobrecarga utiliza la configuración predeterminada para la fragmentación y el reenvío de paquetes.This overload uses default settings for packet fragmentation and packet forwarding. El paquete que contiene el mensaje de eco ICMP se puede fragmentar en tránsito si el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Para evitar la fragmentación, utilice uno de los Send métodos que toma un options parámetro y establezca el DontFragment propiedad true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. Cuando esto sucede, el Status está establecido en PacketTooBig.When this happens, the Status is set to PacketTooBig.

El paquete o sus fragmentos pueden reenviar mediante nodos de enrutamiento 128 veces antes de descartarse.The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. Para cambiar esta configuración, use un Send sobrecarga que toma un options parámetro y establezca el Ttl propiedad en el valor deseado.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Si el paquete no llega a su destino después de que se reenvían el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. Cuando esto sucede, el Status está establecido en TtlExpired.When this happens, the Status is set to TtlExpired.

Seguridad

NetworkInformationPermission
Para enviar un mensaje de eco ICMP.To send an ICMP echo message. Enumeración asociada: PingAssociated enumeration: Ping

Send(IPAddress, Int32, Byte[]) Send(IPAddress, Int32, Byte[]) Send(IPAddress, Int32, Byte[]) Send(IPAddress, Int32, Byte[])

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene la IPAddress especificada y recibir el correspondiente mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.This overload allows you to specify a time-out value for the operation.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer);
public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout, byte[] buffer);
member this.Send : System.Net.IPAddress * int * byte[] -> System.Net.NetworkInformation.PingReply
Public Function Send (address As IPAddress, timeout As Integer, buffer As Byte()) As PingReply

Parámetros

address
IPAddress IPAddress IPAddress IPAddress

IPAddress que identifica el equipo de destino para el mensaje de eco ICMP.An IPAddress that identifies the computer that is the destination for the ICMP echo message.

timeout
Int32 Int32 Int32 Int32

Valor Int32 que especifica el número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

buffer
Byte[]

Matriz de Byte que contiene los datos que se envían con el mensaje de eco ICMP y se devuelven en el mensaje de respuesta de eco ICMP.A Byte array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. La matriz no puede contener más de 65.500 bytes.The array cannot contain more than 65,500 bytes.

Devoluciones

Un objeto PingReply que proporciona información sobre el mensaje de respuesta de eco ICMP, si se recibió alguno, o indica el motivo del error, si no se recibió ningún mensaje.A PingReply object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. El método devolverá PacketTooBig si el paquete supera la Unidad de transmisión máxima (MTU).The method will return PacketTooBig if the packet exceeds the Maximum Transmission Unit (MTU).

Excepciones

El tamaño de buffer es superior a 65.500 bytes.The size of buffer exceeds 65500 bytes.

address es null.address is null.

O bien-or- El valor de buffer es null, o el tamaño de buffer es superior a 65.500 bytes.buffer is null, or the buffer size is greater than 65500 bytes.

address es una dirección IPv6 y el equipo local está ejecutando un sistema operativo anterior a Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Se ha producido una excepción al enviar o recibir los mensajes ICMP.An exception was thrown while sending or receiving the ICMP messages. Para conocer la excepción exacta que se produjo, vea la excepción interna.See the inner exception for the exact exception that was thrown.

Este objeto se ha eliminado.This object has been disposed.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.The following code example demonstrates how to call this method.

void LocalPingTimeout()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   PingReply ^ reply = pingSender->Send( address, timeout, buffer);
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}


public static void LocalPingTimeout ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;
    PingReply reply = pingSender.Send (address, timeout, buffer);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Comentarios

Si no se recibe el mensaje de respuesta de eco ICMP en el tiempo especificado en el timeout parámetro, el eco ICMP se produce un error y el Status propiedad está establecida en TimedOut.If the ICMP echo reply message is not received within the time specified in the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Nota

Al especificar un número muy reducido para timeout, puede recibir la respuesta de Ping aunque timeout milisegundos transcurridos.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Esta sobrecarga utiliza la configuración predeterminada para la fragmentación y el reenvío de paquetes.This overload uses default settings for packet fragmentation and packet forwarding. El paquete que contiene el mensaje de eco ICMP se puede fragmentar en tránsito si el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Para evitar la fragmentación, utilice uno de los Send métodos que toma un options parámetro y establezca el DontFragment propiedad true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. Cuando esto sucede, el Status está establecido en PacketTooBig.When this happens, the Status is set to PacketTooBig.

El paquete o sus fragmentos pueden reenviar mediante nodos de enrutamiento 128 veces antes de descartarse.The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. Para cambiar esta configuración, use un Send sobrecarga que toma un options parámetro y establezca el Ttl propiedad en el valor deseado.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Si el paquete no llega a su destino después de que se reenvían el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. Cuando esto sucede, el Status está establecido en TtlExpired.When this happens, the Status is set to TtlExpired.

Seguridad

NetworkInformationPermission
Para enviar un mensaje de eco ICMP.To send an ICMP echo message. Enumeración asociada: PingAssociated enumeration: Ping

Send(String, Int32) Send(String, Int32) Send(String, Int32) Send(String, Int32)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) al equipo especificado y recibir un mensaje de respuesta de eco ICMP correspondiente de dicho equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Este método permite especificar un valor de tiempo de espera para la operación.This method allows you to specify a time-out value for the operation.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout);
public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout);
member this.Send : string * int -> System.Net.NetworkInformation.PingReply
Public Function Send (hostNameOrAddress As String, timeout As Integer) As PingReply

Parámetros

hostNameOrAddress
String String String String

String que identifica el equipo de destino para el mensaje de eco ICMP.A String that identifies the computer that is the destination for the ICMP echo message. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.The value specified for this parameter can be a host name or a string representation of an IP address.

timeout
Int32 Int32 Int32 Int32

Valor Int32 que especifica el número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

Devoluciones

Un objeto PingReply que proporciona información sobre el mensaje de respuesta de eco ICMP, si se recibió alguno, o indica el motivo del error, si no se recibió ningún mensaje.A PingReply object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

Excepciones

hostNameOrAddress es null o una cadena vacía ("").hostNameOrAddress is null or is an empty string ("").

Se ha producido una excepción al enviar o recibir los mensajes ICMP.An exception was thrown while sending or receiving the ICMP messages. Para conocer la excepción exacta que se produjo, vea la excepción interna.See the inner exception for the exact exception that was thrown.

Este objeto se ha eliminado.This object has been disposed.

Ejemplos

Para obtener un ejemplo que muestra cómo llamar a un Send método, consulte el Ping información general de clases.For an example that demonstrates calling a Send method, see the Ping class overview.

Comentarios

Si no se recibe el mensaje de respuesta de eco ICMP en el tiempo especificado en el timeout parámetro, el eco ICMP se produce un error y el Status propiedad está establecida en TimedOut.If the ICMP echo reply message is not received within the time specified in the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Nota

Al especificar un número muy reducido para timeout, puede recibir la respuesta de Ping aunque timeout milisegundos transcurridos.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Esta sobrecarga utiliza la configuración predeterminada para la fragmentación y el reenvío de paquetes.This overload uses default settings for packet fragmentation and packet forwarding. El paquete que contiene el mensaje de eco ICMP se puede fragmentar en tránsito si el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Para evitar la fragmentación, utilice uno de los Send métodos que toma un options parámetro y establezca el DontFragment propiedad true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. Cuando esto sucede, el Status está establecido en PacketTooBig.When this happens, the Status is set to PacketTooBig. El paquete o sus fragmentos (si está fragmentado) pueden ser reenviados por nodos de enrutamiento 128 veces antes de descartarse.The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. Para cambiar esta configuración, use un Send sobrecarga que toma un options parámetro y establezca el Ttl propiedad en el valor deseado.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Si el paquete no llega a su destino después de que se reenvían el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. Cuando esto sucede, el Status está establecido en TtlExpired.When this happens, the Status is set to TtlExpired.

Seguridad

NetworkInformationPermission
Para enviar un mensaje de eco ICMP.To send an ICMP echo message. Enumeración asociada: PingAssociated enumeration: Ping

Send(IPAddress, Int32) Send(IPAddress, Int32) Send(IPAddress, Int32) Send(IPAddress, Int32)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) con el búfer de datos especificado al equipo que tiene la IPAddress especificada y recibir el correspondiente mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer. Este método permite especificar un valor de tiempo de espera para la operación.This method allows you to specify a time-out value for the operation.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout);
public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout);
member this.Send : System.Net.IPAddress * int -> System.Net.NetworkInformation.PingReply
Public Function Send (address As IPAddress, timeout As Integer) As PingReply

Parámetros

address
IPAddress IPAddress IPAddress IPAddress

IPAddress que identifica el equipo de destino para el mensaje de eco ICMP.An IPAddress that identifies the computer that is the destination for the ICMP echo message.

timeout
Int32 Int32 Int32 Int32

Valor Int32 que especifica el número máximo de milisegundos (después de enviar el mensaje de eco) que hay que esperar hasta recibir el mensaje de respuesta de eco ICMP.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

Devoluciones

Un objeto PingReply que proporciona información sobre el mensaje de respuesta de eco ICMP, si se recibió alguno, o indica el motivo del error, si no se recibió ningún mensaje.A PingReply object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

Excepciones

address es una dirección IPv6 y el equipo local está ejecutando un sistema operativo anterior a Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Se ha producido una excepción al enviar o recibir los mensajes ICMP.An exception was thrown while sending or receiving the ICMP messages. Para conocer la excepción exacta que se produjo, vea la excepción interna.See the inner exception for the exact exception that was thrown.

Este objeto se ha eliminado.This object has been disposed.

Ejemplos

Para obtener un ejemplo que muestra cómo llamar a un Send método, consulte el Ping información general de clases.For an example that demonstrates calling a Send method, see the Ping class overview.

Comentarios

Si no se recibe el mensaje de respuesta de eco ICMP en el tiempo especificado en el timeout parámetro, el eco ICMP se produce un error y el Status propiedad está establecida en TimedOut.If the ICMP echo reply message is not received within the time specified in the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Nota

Al especificar un número muy reducido para timeout, puede recibir la respuesta de Ping aunque timeout milisegundos transcurridos.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Esta sobrecarga utiliza la configuración predeterminada para la fragmentación y el reenvío de paquetes.This overload uses default settings for packet fragmentation and packet forwarding. El paquete que contiene el mensaje de eco ICMP se puede fragmentar en tránsito si el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Para evitar la fragmentación, utilice uno de los Send métodos que toma un options parámetro y establezca el DontFragment propiedad true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. Cuando esto sucede, el Status está establecido en PacketTooBig.When this happens, the Status is set to PacketTooBig.

El paquete o sus fragmentos pueden reenviar mediante nodos de enrutamiento 128 veces antes de descartarse.The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. Para cambiar esta configuración, use un Send sobrecarga que toma un options parámetro y establezca el Ttl propiedad en el valor deseado.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Si el paquete no llega a su destino después de que se reenvían el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. Cuando esto sucede, el Status está establecido en TtlExpired.When this happens, the Status is set to TtlExpired.

Seguridad

NetworkInformationPermission
Para enviar un mensaje de eco ICMP.To send an ICMP echo message. Enumeración asociada: PingAssociated enumeration: Ping

Send(String) Send(String) Send(String) Send(String)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) al equipo especificado y recibir un mensaje de respuesta de eco ICMP correspondiente de dicho equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress);
public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress);
member this.Send : string -> System.Net.NetworkInformation.PingReply
Public Function Send (hostNameOrAddress As String) As PingReply

Parámetros

hostNameOrAddress
String String String String

String que identifica el equipo de destino para el mensaje de eco ICMP.A String that identifies the computer that is the destination for the ICMP echo message. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.The value specified for this parameter can be a host name or a string representation of an IP address.

Devoluciones

Un objeto PingReply que proporciona información sobre el mensaje de respuesta de eco ICMP, si se recibió alguno, o indica el motivo del error, si no se recibió ningún mensaje.A PingReply object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received.

Excepciones

hostNameOrAddress es null o una cadena vacía ("").hostNameOrAddress is null or is an empty string ("").

address es una dirección IPv6 y el equipo local está ejecutando un sistema operativo anterior a Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Se ha producido una excepción al enviar o recibir los mensajes ICMP.An exception was thrown while sending or receiving the ICMP messages. Para conocer la excepción exacta que se produjo, vea la excepción interna.See the inner exception for the exact exception that was thrown.

Este objeto se ha eliminado.This object has been disposed.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.The following code example demonstrates calling this method.

void SimplePing()
{
   Ping ^ pingSender = gcnew Ping;
   PingReply ^ reply = pingSender->Send( "www.contoso.com" );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}


public static void SimplePing ()
{
    Ping pingSender = new Ping ();
    PingReply reply = pingSender.Send ("www.contoso.com");

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Comentarios

Este método envía un 32 Byte búfer de datos con el mensaje de eco ICMP.This method sends a 32 Byte data buffer with the ICMP echo message. El método espera cinco segundos para un mensaje de respuesta de eco ICMP.The method waits five seconds for an ICMP echo reply message. Si no recibe una respuesta en ese momento, el método devuelve y la Status propiedad está establecida en TimedOut.If it does not receive a reply in that time, the method returns and the Status property is set to TimedOut.

Esta sobrecarga utiliza la configuración predeterminada para la fragmentación y el reenvío de paquetes.This overload uses default settings for packet fragmentation and packet forwarding. El paquete que contiene el mensaje de eco ICMP se puede fragmentar en tránsito si el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Para evitar la fragmentación, utilice uno de los Send métodos que toma un options parámetro y establezca el DontFragment propiedad true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. Cuando esto sucede, el Status está establecido en PacketTooBig.When this happens, the Status is set to PacketTooBig. El paquete o sus fragmentos (si está fragmentado) pueden ser reenviados por nodos de enrutamiento 128 veces antes de descartarse.The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. Para cambiar esta configuración, use un Send sobrecarga que toma un options parámetro y establezca el Ttl propiedad en el valor deseado.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Si el paquete no llega a su destino después de que se reenvían el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. Cuando esto sucede, el Status está establecido en TtlExpired.When this happens, the Status is set to TtlExpired.

Seguridad

NetworkInformationPermission
Para enviar un mensaje de eco ICMP.To send an ICMP echo message. Enumeración asociada: PingAssociated enumeration: Ping

Send(IPAddress) Send(IPAddress) Send(IPAddress) Send(IPAddress)

Intenta enviar un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) al equipo que tiene la IPAddress especificada y recibir el correspondiente mensaje de respuesta de eco ICMP de ese equipo.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address);
public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address);
member this.Send : System.Net.IPAddress -> System.Net.NetworkInformation.PingReply
Public Function Send (address As IPAddress) As PingReply

Parámetros

address
IPAddress IPAddress IPAddress IPAddress

IPAddress que identifica el equipo de destino para el mensaje de eco ICMP.An IPAddress that identifies the computer that is the destination for the ICMP echo message.

Devoluciones

Un objeto PingReply que proporciona información sobre el mensaje de respuesta de eco ICMP, si se recibió alguno, o indica el motivo del error, si no se recibió ninguno.A PingReply object that provides information about the ICMP echo reply message, if one was received, or describes the reason for the failure if no message was received.

Excepciones

address es una dirección IPv6 y el equipo local está ejecutando un sistema operativo anterior a Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Se ha producido una excepción al enviar o recibir los mensajes ICMP.An exception was thrown while sending or receiving the ICMP messages. Para conocer la excepción exacta que se produjo, vea la excepción interna.See the inner exception for the exact exception that was thrown.

Este objeto se ha eliminado.This object has been disposed.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.The following code example demonstrates calling this method.

void LocalPing()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   PingReply ^ reply = pingSender->Send( address );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}


public static void LocalPing ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;
    PingReply reply = pingSender.Send (address);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Comentarios

Este método envía al host especificado por address un 32 Byte búfer de datos con el mensaje de eco ICMP.This method sends to the host that is specified by address a 32 Byte data buffer with the ICMP echo message. El método espera cinco segundos para un mensaje de respuesta de eco ICMP.The method waits five seconds for an ICMP echo reply message. Si no recibe una respuesta en ese momento, el método devuelve y la Status propiedad está establecida en TimedOut.If it does not receive a reply in that time, the method returns and the Status property is set to TimedOut.

Esta sobrecarga utiliza la configuración predeterminada para la fragmentación y el reenvío de paquetes.This overload uses default settings for packet fragmentation and packet forwarding. El paquete que contiene el mensaje de eco ICMP se puede fragmentar en tránsito si el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Para evitar la fragmentación, utilice uno de los Send métodos que toma un options parámetro y establezca el DontFragment propiedad true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo de paquetes que se puede transmitir mediante uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. Cuando esto sucede, el Status está establecido en PacketTooBig.When this happens, the Status is set to PacketTooBig. El paquete o sus fragmentos (si está fragmentado) pueden ser reenviados por nodos de enrutamiento 128 veces antes de descartarse.The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. Para cambiar esta configuración, use un Send sobrecarga que toma un options parámetro y establezca el Ttl propiedad en el valor deseado.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Si el paquete no llega a su destino después de que se reenvían el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. Cuando esto sucede, el Status está establecido en TtlExpired.When this happens, the Status is set to TtlExpired.

Seguridad

NetworkInformationPermission
Para enviar un mensaje de eco ICMP.To send an ICMP echo message. Enumeración asociada: PingAssociated enumeration: Ping

Se aplica a