Compartir a través de

Ping.Send Método

  • Referencia

Definición

Espacio de nombres:
System.Net.NetworkInformation
Ensamblado:
System.Net.Ping.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll

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.

Sobrecargas

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

Intenta enviar un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) al equipo especificado y recibir un mensaje de respuesta de eco ICMP correspondiente de ese equipo.
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. 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.
Send(IPAddress, TimeSpan, Byte[], PingOptions)

Intenta enviar un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) al equipo que tiene el especificado IPAddressy para recibir un mensaje de respuesta de eco ICMP correspondiente de ese equipo.
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. 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.
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. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.
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. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.
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. Este método permite especificar un valor de tiempo de espera para la operación.
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. Este método permite especificar un valor de tiempo de espera para la operación.
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.
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.

Comentarios

La dirección IP devuelta por cualquiera de las Send sobrecargas puede originarse en un equipo remoto malintencionado. No se conecte al equipo remoto con esto. Use DNS para determinar la dirección IP de la máquina a la que desea conectarse.

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

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

Intenta enviar un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) al equipo especificado y recibir un mensaje de respuesta de eco ICMP correspondiente de ese equipo.

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

Parámetros

hostNameOrAddress
String

String que identifica el equipo de destino para el mensaje de eco ICMP. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.

timeout
TimeSpan

Valor que especifica la cantidad máxima de tiempo (después de enviar el mensaje de eco) para esperar al mensaje de respuesta de eco ICMP.

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. La matriz no puede contener más de 65.500 bytes.

options
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.

Devoluciones

PingReply

Información sobre el mensaje de respuesta de eco ICMP, si se recibió uno o el motivo del error, si no se recibió ningún mensaje.

Excepciones

ArgumentNullException

buffero es o hostNameOrAddresshostNameOrAddress es null una cadena vacía ("").

ArgumentOutOfRangeException

timeout representa un tiempo menor que cero milisegundos o mayor que MaxValue milisegundos.

ArgumentException

El buffertamaño del es mayor que 65 500 bytes.

InvalidOperationException

Hay una llamada a SendAsync en curso.

PingException

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

ObjectDisposedException

Este objeto se ha eliminado.

Se aplica a

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

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

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. 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.

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);
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 que identifica el equipo de destino para el mensaje de eco ICMP. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.

timeout
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.

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. La matriz no puede contener más de 65.500 bytes.

options
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.

Devoluciones

PingReply

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.

Excepciones

ArgumentException

El tamaño de buffer es superior a 65.500 bytes.

ArgumentNullException

hostNameOrAddress es null o una cadena de longitud cero.

O bien

buffer es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Se está realizando una llamada a SendAsync.

PingException

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

ObjectDisposedException

Este objeto se ha eliminado.

PlatformNotSupportedException

.NET 7 y versiones posteriores solo en Linux: el proceso no tiene privilegios y buffer no está vacío.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.

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 el mensaje de respuesta de eco ICMP no se recibe dentro del tiempo especificado por el timeout parámetro , se produce un error en el eco ICMP y la Status propiedad se establece TimedOuten .

Nota

Al especificar números muy pequeños para timeout, se puede recibir la respuesta ping incluso si timeout han transcurrido milisegundos.

Si la DontFragment propiedad es true y el tamaño total del paquete supera el tamaño máximo de paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP. Cuando esto sucede, Status se establece PacketTooBigen .

Utilice la Ttl propiedad para especificar el número máximo de veces que se puede reenviar el mensaje de eco ICMP antes de alcanzar su destino. Si el paquete no llega a su destino después de reenviarse el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP. Cuando esto sucede, Status se establece TtlExpireden .

Se aplica a

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

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

Intenta enviar un mensaje de eco del Protocolo de mensajes de control de Internet (ICMP) al equipo que tiene el especificado IPAddressy para recibir un mensaje de respuesta de eco ICMP correspondiente de ese equipo.

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

Parámetros

address
IPAddress

IPAddress que identifica el equipo de destino para el mensaje de eco ICMP.

timeout
TimeSpan

Valor que especifica la cantidad máxima de tiempo (después de enviar el mensaje de eco) para esperar al mensaje de respuesta de eco ICMP.

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. La matriz no puede contener más de 65.500 bytes.

options
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.

Devoluciones

PingReply

Información sobre el mensaje de respuesta de eco ICMP, si se recibió uno o el motivo del error, si no se recibió ningún mensaje.

Excepciones

ArgumentNullException

address o buffer es null.

ArgumentOutOfRangeException

timeout representa un tiempo menor que cero milisegundos o mayor que MaxValue milisegundos.

ArgumentException

El buffertamaño del es mayor que 65 500 bytes.

InvalidOperationException

Hay una llamada a SendAsync en curso.

PingException

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

ObjectDisposedException

Este objeto se ha eliminado.

Se aplica a

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

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

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. 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.

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);
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 que identifica el equipo de destino para el mensaje de eco ICMP.

timeout
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.

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. La matriz no puede contener más de 65.500 bytes.

options
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.

Devoluciones

PingReply

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. El método devolverá PacketTooBig si el paquete supera la Unidad de transmisión máxima (MTU).

Excepciones

ArgumentException

El tamaño de buffer es superior a 65.500 bytes.

ArgumentNullException

address o buffer es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Se está realizando una llamada a SendAsync.

PingException

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

ObjectDisposedException

Este objeto se ha eliminado.

PlatformNotSupportedException

.NET 7 y versiones posteriores solo en Linux: el proceso no tiene privilegios y buffer no está vacío.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.

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 el mensaje de respuesta de eco ICMP no se recibe dentro del tiempo especificado por el timeout parámetro , se produce un error en el eco ICMP y la Status propiedad se establece TimedOuten .

Nota

Al especificar números muy pequeños para timeout, se puede recibir la respuesta ping incluso si timeout han transcurrido milisegundos.

Si la DontFragment propiedad es true y el tamaño total del paquete supera el tamaño máximo del paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece PacketTooBigen Status .

Utilice la 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. Si el paquete no llega a su destino después de reenviarse el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece TtlExpireden Status .

Se aplica a

Send(String, Int32, Byte[])

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

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. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.

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 que identifica el equipo de destino para el mensaje de eco ICMP. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.

timeout
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.

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. La matriz no puede contener más de 65.500 bytes.

Devoluciones

PingReply

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.

Excepciones

ArgumentException

El tamaño de buffer es superior a 65.500 bytes.

ArgumentNullException

hostNameOrAddress es null o una cadena vacía ("").

O bien

buffer es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Se está realizando una llamada a SendAsync.

PingException

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

ObjectDisposedException

Este objeto se ha eliminado.

PlatformNotSupportedException

.NET 7 y versiones posteriores solo en Linux: el proceso no tiene privilegios y buffer no está vacío.

Ejemplos

Para ver un ejemplo que muestra cómo llamar a una Send sobrecarga, consulte la información general de la Ping clase.

Comentarios

Si el mensaje de respuesta de eco ICMP no se recibe dentro del tiempo especificado en el timeout parámetro , se produce un error en el eco ICMP y la Status propiedad se establece TimedOuten .

Nota

Al especificar números muy pequeños para timeout, se puede recibir la respuesta ping incluso si timeout han transcurrido milisegundos.

Esta sobrecarga usa la configuración predeterminada para la fragmentación de paquetes y el reenvío de paquetes. 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 paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos. Para evitar la fragmentación, use uno de los Send métodos que toma un options parámetro y establezca la DontFragment propiedad trueen . Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo del paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece PacketTooBigen Status .

Los fragmentos de paquetes o paquetes se pueden reenviar mediante el enrutamiento de los nodos 128 veces antes de descartarse. Para cambiar esta configuración, use una Send sobrecarga que tome un options parámetro y establezca la Ttl propiedad en el valor deseado. Si el paquete no llega a su destino después de reenviarse el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece TtlExpireden Status .

Se aplica a

Send(IPAddress, Int32, Byte[])

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

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. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.

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 que identifica el equipo de destino para el mensaje de eco ICMP.

timeout
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.

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. La matriz no puede contener más de 65.500 bytes.

Devoluciones

PingReply

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. El método devolverá PacketTooBig si el paquete supera la Unidad de transmisión máxima (MTU).

Excepciones

ArgumentException

El tamaño de buffer es superior a 65.500 bytes.

ArgumentNullException

address o buffer es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Se está realizando una llamada a SendAsync.

PingException

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

ObjectDisposedException

Este objeto se ha eliminado.

PlatformNotSupportedException

.NET 7 y versiones posteriores solo en Linux: el proceso no tiene privilegios y buffer no está vacío.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.

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 el mensaje de respuesta de eco ICMP no se recibe dentro del tiempo especificado en el timeout parámetro , se produce un error en el eco ICMP y la Status propiedad se establece TimedOuten .

Nota

Al especificar números muy pequeños para timeout, se puede recibir la respuesta ping incluso si timeout han transcurrido milisegundos.

Esta sobrecarga usa la configuración predeterminada para la fragmentación de paquetes y el reenvío de paquetes. 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 paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos. Para evitar la fragmentación, use uno de los Send métodos que toma un options parámetro y establezca la DontFragment propiedad trueen . Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo del paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece PacketTooBigen Status .

Los fragmentos de paquetes o paquetes se pueden reenviar mediante el enrutamiento de los nodos 128 veces antes de descartarse. Para cambiar esta configuración, use una Send sobrecarga que tome un options parámetro y establezca la Ttl propiedad en el valor deseado. Si el paquete no llega a su destino después de reenviarse el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece TtlExpireden Status .

Se aplica a

Send(String, Int32)

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

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. Este método permite especificar un valor de tiempo de espera para la operación.

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 que identifica el equipo de destino para el mensaje de eco ICMP. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.

timeout
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.

Devoluciones

PingReply

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.

Excepciones

ArgumentNullException

hostNameOrAddress es null o una cadena vacía ("").

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Se está realizando una llamada a SendAsync.

PingException

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

ObjectDisposedException

Este objeto se ha eliminado.

Ejemplos

Para ver un ejemplo que muestra cómo llamar a un Send método, consulte la información general de la Ping clase.

Comentarios

Si el mensaje de respuesta de eco ICMP no se recibe dentro del tiempo especificado en el timeout parámetro , se produce un error en el eco ICMP y la Status propiedad se establece TimedOuten .

Nota

Al especificar números muy pequeños para timeout, se puede recibir la respuesta ping incluso si timeout han transcurrido milisegundos.

Esta sobrecarga usa la configuración predeterminada para la fragmentación de paquetes y el reenvío de paquetes. 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 paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos. Para evitar la fragmentación, use uno de los Send métodos que toma un options parámetro y establezca la DontFragment propiedad trueen . Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo del paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece PacketTooBigen Status . Los fragmentos de paquetes o paquetes (si están fragmentados) se pueden reenviar mediante el enrutamiento de los nodos 128 veces antes de descartarse. Para cambiar esta configuración, use una Send sobrecarga que tome un options parámetro y establezca la Ttl propiedad en el valor deseado. Si el paquete no llega a su destino después de reenviarse el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece TtlExpireden Status .

Se aplica a

Send(IPAddress, Int32)

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

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. Este método permite especificar un valor de tiempo de espera para la operación.

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 que identifica el equipo de destino para el mensaje de eco ICMP.

timeout
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.

Devoluciones

PingReply

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.

Excepciones

ArgumentNullException

address es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Se está realizando una llamada a SendAsync.

PingException

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

ObjectDisposedException

Este objeto se ha eliminado.

Ejemplos

Para ver un ejemplo que muestra cómo llamar a un Send método, consulte la información general de la Ping clase.

Comentarios

Si el mensaje de respuesta de eco ICMP no se recibe dentro del tiempo especificado en el timeout parámetro , se produce un error en el eco ICMP y la Status propiedad se establece TimedOuten .

Nota

Al especificar números muy pequeños para timeout, se puede recibir la respuesta ping incluso si timeout han transcurrido milisegundos.

Esta sobrecarga usa la configuración predeterminada para la fragmentación de paquetes y el reenvío de paquetes. 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 paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos. Para evitar la fragmentación, use uno de los Send métodos que toma un options parámetro y establezca la DontFragment propiedad trueen . Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo del paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece PacketTooBigen Status .

Los fragmentos de paquetes o paquetes se pueden reenviar mediante el enrutamiento de los nodos 128 veces antes de descartarse. Para cambiar esta configuración, use una Send sobrecarga que tome un options parámetro y establezca la Ttl propiedad en el valor deseado. Si el paquete no llega a su destino después de reenviarse el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece TtlExpireden Status .

Se aplica a

Send(String)

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

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.

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 que identifica el equipo de destino para el mensaje de eco ICMP. El valor especificado para este parámetro puede ser un nombre de host o una representación de cadena de una dirección IP.

Devoluciones

PingReply

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.

Excepciones

ArgumentNullException

hostNameOrAddress es null o una cadena vacía ("").

InvalidOperationException

Se está realizando una llamada a SendAsync.

PingException

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

ObjectDisposedException

Este objeto se ha eliminado.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.

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 búfer de datos 32 Byte con el mensaje de eco ICMP. El método espera cinco segundos para un mensaje de respuesta de eco ICMP. Si no recibe una respuesta en ese momento, el método devuelve y la Status propiedad se establece TimedOuten .

Esta sobrecarga usa la configuración predeterminada para la fragmentación de paquetes y el reenvío de paquetes. 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 paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos. Para evitar la fragmentación, use uno de los Send métodos que toma un options parámetro y establezca la DontFragment propiedad trueen . Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo del paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece PacketTooBigen Status . Los fragmentos de paquetes o paquetes (si están fragmentados) se pueden reenviar mediante el enrutamiento de los nodos 128 veces antes de descartarse. Para cambiar esta configuración, use una Send sobrecarga que tome un options parámetro y establezca la Ttl propiedad en el valor deseado. Si el paquete no llega a su destino después de reenviarse el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece TtlExpireden Status .

Se aplica a

Send(IPAddress)

Source:
Ping.cs
Source:
Ping.cs
Source:
Ping.cs

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.

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 que identifica el equipo de destino para el mensaje de eco ICMP.

Devoluciones

PingReply

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.

Excepciones

ArgumentNullException

address es null.

InvalidOperationException

Se está realizando una llamada a SendAsync.

PingException

Se ha producido una excepción al enviar o recibir los mensajes ICMP. Para conocer la excepción exacta que se produjo, vea la excepción interna.

ObjectDisposedException

Este objeto se ha eliminado.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.

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 búfer de datos 32 Byte con el mensaje de eco ICMP. El método espera cinco segundos para un mensaje de respuesta de eco ICMP. Si no recibe una respuesta en ese momento, el método devuelve y la Status propiedad se establece TimedOuten .

Esta sobrecarga usa la configuración predeterminada para la fragmentación de paquetes y el reenvío de paquetes. 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 paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos. Para evitar la fragmentación, use uno de los Send métodos que toma un options parámetro y establezca la DontFragment propiedad trueen . Cuando DontFragment es true y el tamaño total del paquete supera el tamaño máximo del paquete que puede transmitir uno de los nodos de enrutamiento entre los equipos locales y remotos, se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece PacketTooBigen Status . Los fragmentos de paquetes o paquetes (si están fragmentados) se pueden reenviar mediante el enrutamiento de los nodos 128 veces antes de descartarse. Para cambiar esta configuración, use una Send sobrecarga que tome un options parámetro y establezca la Ttl propiedad en el valor deseado. Si el paquete no llega a su destino después de reenviarse el número de veces especificado, el paquete se descarta y se produce un error en la solicitud de eco ICMP. Cuando esto sucede, se establece TtlExpireden Status .

Se aplica a