Ping.SendAsync Método

Referencia

Definición

Espacio de nombres:: System.Net.NetworkInformation

Ensamblado:: System.Net.Ping.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Intenta enviar de forma asincrónica 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.

Sobrecargas

SendAsync(String, Int32, Byte[], PingOptions, Object)	De forma asincrónica, 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.
SendAsync(IPAddress, Int32, Byte[], PingOptions, Object)	De forma asincrónica, 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 y controlar los valores de Período de vida y fragmentación para el paquete del mensaje de eco ICMP.
SendAsync(String, Int32, Byte[], Object)	De forma asincrónica, 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.
SendAsync(IPAddress, Int32, Byte[], Object)	De forma asincrónica, 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.
SendAsync(IPAddress, Int32, Object)	Intenta enviar de forma asincrónica un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) al equipo que tiene la IPAddress especificada y recibir un mensaje de respuesta de eco ICMP correspondiente de dicho equipo. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.
SendAsync(String, Object)	Intenta enviar de forma asincrónica 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.
SendAsync(IPAddress, Object)	Intenta enviar de forma asincrónica un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) al equipo que tiene la IPAddress especificada y recibir un mensaje de respuesta de eco ICMP correspondiente de dicho equipo.
SendAsync(String, Int32, Object)	Intenta enviar de forma asincrónica 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. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.

Comentarios

Estos métodos no hacen que el subproceso principal de la aplicación se bloquee. Si desea bloquear mientras espera el mensaje de respuesta de eco ICMP, use los Send métodos .

Nota

La dirección IP devuelta por cualquiera de los SendAsync métodos 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.

SendAsync(String, Int32, Byte[], PingOptions, Object)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

De forma asincrónica, 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:
 void SendAsync(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options, System::Object ^ userToken);

public void SendAsync (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions? options, object? userToken);

public void SendAsync (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options, object userToken);

member this.SendAsync : string * int * byte[] * System.Net.NetworkInformation.PingOptions * obj -> unit

Public Sub SendAsync (hostNameOrAddress As String, timeout As Integer, buffer As Byte(), options As PingOptions, userToken As Object)

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.

userToken: Object

Objeto que se pasa al método invocado cuando la operación asincrónica termina.

Excepciones

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.

SocketException

hostNameOrAddress no pudo resolverse en una dirección IP válida.

ObjectDisposedException

Este objeto se ha eliminado.

ArgumentException

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

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.

#using <System.dll>

using namespace System;
using namespace System::Text;
using namespace System::Net;
using namespace System::Net::NetworkInformation;
using namespace System::ComponentModel;
using namespace System::Threading;
void PingCompletedCallback( Object^ sender, PingCompletedEventArgs^ e );
void DisplayReply( PingReply^ reply );
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   if ( args->Length == 1 )
      throw gcnew ArgumentException( "Ping needs a host or IP Address." );

   String^ who = args[ 1 ];
   AutoResetEvent^ waiter = gcnew AutoResetEvent( false );
   
   Ping ^ pingSender = gcnew Ping;
   
   // When the PingCompleted event is raised,
   // the PingCompletedCallback method is called.
   pingSender->PingCompleted += gcnew PingCompletedEventHandler( PingCompletedCallback );
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 12 seconds for a reply.
   int timeout = 12000;
   
   // 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 );
   Console::WriteLine( "Time to live: {0}", options->Ttl );
   Console::WriteLine( "Don't fragment: {0}", options->DontFragment );
   
   // Send the ping asynchronously.
   // Use the waiter as the user token.
   // When the callback completes, it can wake up this thread.
   pingSender->SendAsync( who, timeout, buffer, options, waiter );
   
   // Prevent this example application from ending.
   // A real application should do something useful
   // when possible.
   waiter->WaitOne();
   Console::WriteLine( "Ping example completed." );
}


void PingCompletedCallback( Object^ /*sender*/, PingCompletedEventArgs^ e )
{
   
   // If the operation was canceled, display a message to the user.
   if ( e->Cancelled )
   {
      Console::WriteLine( "Ping canceled." );
      
      // Let the main thread resume. 
      // UserToken is the AutoResetEvent object that the main thread 
      // is waiting for.
      (dynamic_cast<AutoResetEvent^>(e->UserState))->Set();
   }

   
   // If an error occurred, display the exception to the user.
   if ( e->Error != nullptr )
   {
      Console::WriteLine( "Ping failed:" );
      Console::WriteLine( e->Error->ToString() );
      
      // Let the main thread resume. 
      (dynamic_cast<AutoResetEvent^>(e->UserState))->Set();
   }

   PingReply ^ reply = e->Reply;
   DisplayReply( reply );
   
   // Let the main thread resume.
   (dynamic_cast<AutoResetEvent^>(e->UserState))->Set();
}


void DisplayReply( PingReply ^ reply )
{
   if ( reply == nullptr )
      return;

   Console::WriteLine( "ping status: {0}", reply->Status );
   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 );
   }
}

using System;
using System.Text;
using System.Net;
using System.Net.NetworkInformation;
using System.ComponentModel;
using System.Threading;

namespace Examples.System.Net.NetworkInformation.PingTest
{
    public class PingExample
    {
        public static void Main (string[] args)
        {
            if (args.Length == 0)
                throw new ArgumentException ("Ping needs a host or IP Address.");

            string who = args[0];
            AutoResetEvent waiter = new AutoResetEvent (false);

            Ping pingSender = new Ping ();

            // When the PingCompleted event is raised,
            // the PingCompletedCallback method is called.
            pingSender.PingCompleted += new PingCompletedEventHandler (PingCompletedCallback);

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

            // Wait 12 seconds for a reply.
            int timeout = 12000;

            // 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);

            Console.WriteLine ("Time to live: {0}", options.Ttl);
            Console.WriteLine ("Don't fragment: {0}", options.DontFragment);

            // Send the ping asynchronously.
            // Use the waiter as the user token.
            // When the callback completes, it can wake up this thread.
            pingSender.SendAsync(who, timeout, buffer, options, waiter);

            // Prevent this example application from ending.
            // A real application should do something useful
            // when possible.
            waiter.WaitOne ();
            Console.WriteLine ("Ping example completed.");
        }

        private static void PingCompletedCallback (object sender, PingCompletedEventArgs e)
        {
            // If the operation was canceled, display a message to the user.
            if (e.Cancelled)
            {
                Console.WriteLine ("Ping canceled.");

                // Let the main thread resume.
                // UserToken is the AutoResetEvent object that the main thread
                // is waiting for.
                ((AutoResetEvent)e.UserState).Set ();
            }

            // If an error occurred, display the exception to the user.
            if (e.Error != null)
            {
                Console.WriteLine ("Ping failed:");
                Console.WriteLine (e.Error.ToString ());

                // Let the main thread resume.
                ((AutoResetEvent)e.UserState).Set();
            }

            PingReply reply = e.Reply;

            DisplayReply (reply);

            // Let the main thread resume.
            ((AutoResetEvent)e.UserState).Set();
        }

        public static void DisplayReply (PingReply reply)
        {
            if (reply == null)
                return;

            Console.WriteLine ("ping status: {0}", reply.Status);
            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);
            }
        }
    }
}

Comentarios

El SendAsync método envía el mensaje Echo de forma asincrónica y, cuando la operación se completa (correctamente o sin éxito), devuelve el estado a la aplicación. Llame al SendAsync método cuando la aplicación no debe bloquearse. Cada llamada se ejecuta en un subproceso independiente que se asigna automáticamente desde el grupo de subprocesos. Cuando se completa la operación asincrónica, genera el PingCompleted evento . Las aplicaciones usan un PingCompletedEventHandler delegado para especificar el método al que se llama cuando SendAsync genera el evento. Debe agregar un PingCompletedEventHandler delegado al evento antes de llamar a SendAsync. El método del delegado recibe un PingCompletedEventArgs objeto que contiene un PingReply objeto que describe el resultado de la SendAsync llamada. El PingCompletedEventArgs objeto hereda la UserState propiedad . Esta propiedad contiene el userToken objeto pasado a la SendAsync llamada.

Si la aplicación debe bloquearse mientras espera una respuesta, use los Send métodos ; estos métodos son sincrónicos.

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

SendAsync(IPAddress, Int32, Byte[], PingOptions, Object)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

De forma asincrónica, 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 y controlar los valores de Período de vida y fragmentación para el paquete del mensaje de eco ICMP.

public:
 void SendAsync(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options, System::Object ^ userToken);

public void SendAsync (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions? options, object? userToken);

public void SendAsync (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options, object userToken);

member this.SendAsync : System.Net.IPAddress * int * byte[] * System.Net.NetworkInformation.PingOptions * obj -> unit

Public Sub SendAsync (address As IPAddress, timeout As Integer, buffer As Byte(), options As PingOptions, userToken As Object)

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.

userToken: Object

Objeto que se pasa al método invocado cuando la operación asincrónica termina.

Excepciones

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.

SocketException

El valor de address no es una dirección IP válida.

ObjectDisposedException

Este objeto se ha eliminado.

ArgumentException

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

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. Para obtener una implementación del método de devolución de llamada, consulte la sección ejemplo de sobrecarga de SendAsync métodos.

En el ejemplo de código siguiente se requieren los siguientes espacios de nombres:

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::Net::NetworkInformation;
using namespace System::Text;
using namespace System::Threading;

using System;
using System.Net;
using System.Net.NetworkInformation;
using System.Text;
using System.Threading;

En el ejemplo de código siguiente se envía un mensaje de eco ICMP de forma asincrónica.

void AsyncComplexLocalPing()
{
   
   // Get an object that will block the main thread.
   AutoResetEvent^ waiter = gcnew AutoResetEvent( false );
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   
   // When the PingCompleted event is raised,
   // the PingCompletedCallback method is called.
   pingSender->PingCompleted += gcnew PingCompletedEventHandler( PingCompletedCallback );
   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 );
   
   // Send the ping asynchronously.
   // Use the waiter as the user token.
   // When the callback completes, it can wake up this thread.
   pingSender->SendAsync( address, timeout, buffer, options, waiter );
   
   // Prevent this example application from ending.
   // A real application should do something useful
   // when possible.
   waiter->WaitOne();
   Console::WriteLine( "Ping example completed." );
}

public static void AsyncComplexLocalPing ()
{
    // Get an object that will block the main thread.
    AutoResetEvent waiter = new AutoResetEvent (false);

    // Ping's the local machine.
    Ping pingSender = new Ping ();

    // When the PingCompleted event is raised,
    // the PingCompletedCallback method is called.
    pingSender.PingCompleted += new PingCompletedEventHandler (PingCompletedCallback);

    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);

    // Send the ping asynchronously.
    // Use the waiter as the user token.
    // When the callback completes, it can wake up this thread.
    pingSender.SendAsync (address, timeout, buffer, options, waiter);

    // Prevent this example application from ending.
    // A real application should do something useful
    // when possible.
    waiter.WaitOne ();
    Console.WriteLine ("Ping example completed.");
}

Comentarios

Si la aplicación se bloquea mientras espera una respuesta, use los Send métodos ; estos métodos son sincrónicos.

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.

Se aplica a

SendAsync(String, Int32, Byte[], Object)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

public:
 void SendAsync(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer, System::Object ^ userToken);

public void SendAsync (string hostNameOrAddress, int timeout, byte[] buffer, object? userToken);

public void SendAsync (string hostNameOrAddress, int timeout, byte[] buffer, object userToken);

member this.SendAsync : string * int * byte[] * obj -> unit

Public Sub SendAsync (hostNameOrAddress As String, timeout As Integer, buffer As Byte(), userToken As Object)

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.

userToken: Object

Objeto que se pasa al método invocado cuando la operación asincrónica termina.

Excepciones

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.

SocketException

hostNameOrAddress no pudo resolverse en una dirección IP válida.

ObjectDisposedException

Este objeto se ha eliminado.

ArgumentException

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

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 una SendAsync sobrecarga, consulte la información general de la Ping clase.

Comentarios

El SendAsync método envía el mensaje Echo de forma asincrónica y, cuando la operación se completa (correctamente o sin éxito), devuelve el estado a la aplicación. Llame al SendAsync método cuando la aplicación no se bloquee. Cada llamada se ejecuta en un subproceso independiente que se asigna automáticamente desde el grupo de subprocesos. Cuando se completa la operación asincrónica, genera el PingCompleted evento . Las aplicaciones usan un PingCompletedEventHandler delegado para especificar el método al que se llama cuando SendAsync genera el evento. Debe agregar un PingCompletedEventHandler delegado al evento antes de llamar a SendAsync. El método del delegado recibe un PingCompletedEventArgs objeto que contiene un PingReply objeto que describe el resultado de la SendAsync llamada. El PingCompletedEventArgs objeto hereda la UserState propiedad . Esta propiedad contiene el userToken objeto pasado a la SendAsync llamada.

Si la aplicación debe bloquearse mientras espera una respuesta, use los Send métodos ; estos métodos son sincrónicos.

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.

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

SendAsync(IPAddress, Int32, Byte[], Object)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

public:
 void SendAsync(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer, System::Object ^ userToken);

public void SendAsync (System.Net.IPAddress address, int timeout, byte[] buffer, object? userToken);

public void SendAsync (System.Net.IPAddress address, int timeout, byte[] buffer, object userToken);

member this.SendAsync : System.Net.IPAddress * int * byte[] * obj -> unit

Public Sub SendAsync (address As IPAddress, timeout As Integer, buffer As Byte(), userToken As Object)

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.

userToken: Object

Objeto que se pasa al método invocado cuando la operación asincrónica termina.

Excepciones

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.

SocketException

El valor de address no es una dirección IP válida.

ObjectDisposedException

Este objeto se ha eliminado.

ArgumentException

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

PlatformNotSupportedException

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

Ejemplos

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

Comentarios

Este método envía el mensaje de eco de forma asincrónica y, cuando la operación se completa (correctamente o sin éxito), devuelve el estado a la aplicación. Llame al SendAsync método cuando la aplicación no se bloquee. Cada llamada se ejecuta en un subproceso independiente que se asigna automáticamente desde el grupo de subprocesos. Cuando se completa la operación asincrónica, genera el PingCompleted evento . Para especificar el método al que se llama cuando SendAsync genera el evento, debe agregar un PingCompletedEventHandler delegado al evento antes de llamar a SendAsync. El método del delegado recibe un PingCompletedEventArgs objeto que contiene un PingReply objeto que describe el resultado de la SendAsync llamada. El PingCompletedEventArgs objeto hereda la UserState propiedad . Esta propiedad contiene el userToken objeto pasado a la SendAsync llamada.

Nota

Si la aplicación se bloquea mientras espera una respuesta, use los Send métodos ; estos métodos son sincrónicos.

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.

Se aplica a

SendAsync(IPAddress, Int32, Object)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Intenta enviar de forma asincrónica un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) al equipo que tiene la IPAddress especificada y recibir un mensaje de respuesta de eco ICMP correspondiente de dicho equipo. Esta sobrecarga permite especificar un valor de tiempo de espera para la operación.

public:
 void SendAsync(System::Net::IPAddress ^ address, int timeout, System::Object ^ userToken);

public void SendAsync (System.Net.IPAddress address, int timeout, object? userToken);

public void SendAsync (System.Net.IPAddress address, int timeout, object userToken);

member this.SendAsync : System.Net.IPAddress * int * obj -> unit

Public Sub SendAsync (address As IPAddress, timeout As Integer, userToken As Object)

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.

userToken: Object

Objeto que se pasa al método invocado cuando la operación asincrónica termina.

Excepciones

ArgumentNullException

address es null.

ArgumentOutOfRangeException

timeout es menor que cero.

InvalidOperationException

Se está realizando una llamada al método SendAsync(IPAddress, Int32, Byte[], Object).

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.

SocketException

El valor de address no es una dirección IP válida.

ObjectDisposedException

Este objeto se ha eliminado.

Ejemplos

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

Comentarios

El SendAsync método envía el mensaje Echo de forma asincrónica y, cuando la operación se completa (correctamente o sin éxito), devuelve el estado a la aplicación. Llame al SendAsync método cuando la aplicación no se bloquee. Cada llamada se ejecuta en un subproceso independiente que se asigna automáticamente desde el grupo de subprocesos. Cuando se completa la operación asincrónica, genera el PingCompleted evento . Las aplicaciones usan un PingCompletedEventHandler delegado para especificar el método al que se llama cuando SendAsync genera el evento. Debe agregar un PingCompletedEventHandler delegado al evento antes de llamar a SendAsync. El método del delegado recibe un PingCompletedEventArgs objeto que contiene un PingReply objeto que describe el resultado de la SendAsync llamada. El PingCompletedEventArgs objeto hereda la UserState propiedad . Esta propiedad contiene el userToken objeto pasado a la SendAsync llamada.

Si la aplicación debe bloquearse mientras espera una respuesta, use los Send métodos ; estos métodos son sincrónicos.

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.

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 SendAsync 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 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 . Los fragmentos de paquetes o paquetes (si se fragmentan) se pueden reenviar mediante nodos de enrutamiento 128 veces antes de descartarse. Para cambiar esta configuración, use una SendAsync sobrecarga que toma 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, Status se establece TtlExpireden .

Se aplica a

SendAsync(String, Object)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

public:
 void SendAsync(System::String ^ hostNameOrAddress, System::Object ^ userToken);

public void SendAsync (string hostNameOrAddress, object? userToken);

public void SendAsync (string hostNameOrAddress, object userToken);

member this.SendAsync : string * obj -> unit

Public Sub SendAsync (hostNameOrAddress As String, userToken As Object)

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.

userToken: Object

Objeto que se pasa al método invocado cuando la operación asincrónica termina.

Excepciones

ArgumentNullException

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

InvalidOperationException

Se está realizando una llamada al método SendAsync(String, Object).

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.

SocketException

hostNameOrAddress no pudo resolverse en una dirección IP válida.

ObjectDisposedException

Este objeto se ha eliminado.

Ejemplos

Para obtener un ejemplo de código que muestra cómo llamar al SendAsync método , consulte la información general de la Ping clase.

Comentarios

El SendAsync método envía el mensaje de eco de forma asincrónica y, cuando la operación se completa (correctamente o sin éxito), devuelve el estado a la aplicación. Llame al SendAsync método cuando la aplicación no se bloquee. Cada llamada a este método se ejecuta en un subproceso independiente que se asigna automáticamente desde el grupo de subprocesos. Cuando se completa la operación asincrónica, genera el PingCompleted evento . Para especificar el método al que se llama cuando SendAsync genera el evento, debe agregar un PingCompletedEventHandler delegado al evento antes de llamar a SendAsync. El método del delegado recibe un PingCompletedEventArgs objeto que contiene un PingReply objeto que describe el resultado de la SendAsync llamada. El PingCompletedEventArgs objeto hereda la UserState propiedad . Esta propiedad contiene el userToken objeto pasado a la SendAsync llamada.

Nota

Si la aplicación debe bloquearse mientras espera una respuesta, use los Send métodos ; estos métodos son sincrónicos.

Este método envía un búfer de datos de 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 .

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 SendAsync sobrecarga que toma 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, Status se establece TtlExpireden .

Se aplica a

SendAsync(IPAddress, Object)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

public:
 void SendAsync(System::Net::IPAddress ^ address, System::Object ^ userToken);

public void SendAsync (System.Net.IPAddress address, object? userToken);

public void SendAsync (System.Net.IPAddress address, object userToken);

member this.SendAsync : System.Net.IPAddress * obj -> unit

Public Sub SendAsync (address As IPAddress, userToken As Object)

Parámetros

address: IPAddress

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

userToken: Object

Objeto que se pasa al método invocado cuando la operación asincrónica termina.

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.

SocketException

El valor de address no es una dirección IP válida.

ObjectDisposedException

Este objeto se ha eliminado.

Ejemplos

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

Comentarios

Nota

Si la aplicación debe bloquearse mientras espera una respuesta, use uno de los Send métodos ; estos métodos son sincrónicos.

Se aplica a

SendAsync(String, Int32, Object)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

public:
 void SendAsync(System::String ^ hostNameOrAddress, int timeout, System::Object ^ userToken);

public void SendAsync (string hostNameOrAddress, int timeout, object? userToken);

public void SendAsync (string hostNameOrAddress, int timeout, object userToken);

member this.SendAsync : string * int * obj -> unit

Public Sub SendAsync (hostNameOrAddress As String, timeout As Integer, userToken As Object)

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.

userToken: Object

Objeto que se pasa al método invocado cuando la operación asincrónica termina.

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.

SocketException

hostNameOrAddress no pudo resolverse en una dirección IP válida.

ObjectDisposedException

Este objeto se ha eliminado.

Ejemplos

Para obtener un ejemplo de código que muestra cómo llamar al SendAsync método , consulte la información general de la Ping clase.

Comentarios

El SendAsync método envía el mensaje Echo de forma asincrónica y, cuando la operación se completa (correctamente o sin éxito), devuelve el estado a la aplicación. Llame al SendAsync método cuando la aplicación no se bloquee. Cada llamada se ejecuta en un subproceso independiente que se asigna automáticamente desde el grupo de subprocesos. Cuando se completa la operación asincrónica, genera el PingCompleted evento . Las aplicaciones usan un PingCompletedEventHandler delegado para especificar el método al que se llama cuando SendAsync genera el evento. Debe agregar un PingCompletedEventHandler delegado al evento antes de llamar a SendAsync. El método del delegado recibe un PingCompletedEventArgs objeto que contiene un PingReply objeto que describe el resultado de la SendAsync llamada. El PingCompletedEventArgs objeto hereda la UserState propiedad . Esta propiedad contiene el userToken objeto pasado a la SendAsync llamada.

Si la aplicación debe bloquearse mientras espera una respuesta, use los Send métodos ; estos métodos son sincrónicos.

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.

Se aplica a

Compartir a través de

Ping.SendAsync Método

Definición

Sobrecargas

Comentarios

SendAsync(String, Int32, Byte[], PingOptions, Object)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

SendAsync(IPAddress, Int32, Byte[], PingOptions, Object)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

SendAsync(String, Int32, Byte[], Object)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

SendAsync(IPAddress, Int32, Byte[], Object)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

SendAsync(IPAddress, Int32, Object)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

SendAsync(String, Object)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

SendAsync(IPAddress, Object)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

SendAsync(String, Int32, Object)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

Recursos adicionales