Ping.Send Método

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

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

Devoluções

Informação sobre a mensagem de resposta eco ICMP, se foi recebida, ou a razão da falha, caso nenhuma mensagem tenha sido recebida.

Exceções

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

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

Devoluções

Um PingReply objeto que fornece informação sobre a mensagem de resposta eco ICMP, caso uma tenha sido recebida, ou fornece a razão da falha se nenhuma mensagem foi recebida.

Exceções

Exemplos

O seguinte exemplo de código demonstra como chamar este método.

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

Observações

Se a mensagem de resposta de eco ICMP não for recebida dentro do tempo especificado pelo timeout parâmetro, o eco ICMP falha, e a Status propriedade é definida para TimedOut.

Se a DontFragment propriedade for true e o tamanho total do pacote exceder o tamanho máximo do pacote que pode ser transmitido por um dos nós de encaminhamento entre os computadores local e remoto, o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para PacketTooBig.

Use esta Ttl propriedade para especificar o número máximo de vezes que a mensagem de eco ICMP pode ser encaminhada antes de chegar ao seu destino. Se o pacote não chegar ao seu destino após ser encaminhado o número de vezes especificado, o pacote é descartado e o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para TtlExpired.

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

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

Devoluções

Informação sobre a mensagem de resposta eco ICMP, se foi recebida, ou a razão da falha, caso nenhuma mensagem tenha sido recebida.

Exceções

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

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

Devoluções

Um PingReply objeto que fornece informação sobre a mensagem de resposta eco ICMP, caso tenha sido recebida, ou que fornece a razão da falha, caso nenhuma mensagem tenha sido recebida. O método retorna PacketTooBig se o pacote exceder a Unidade Máxima de Transmissão (MTU).

Exceções

Exemplos

O seguinte exemplo de código demonstra como chamar este método.

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

Observações

Se a mensagem de resposta de eco ICMP não for recebida dentro do tempo especificado pelo timeout parâmetro, o eco ICMP falha, e a Status propriedade é definida para TimedOut.

Se a DontFragment propriedade for true e o tamanho total do pacote exceder o tamanho máximo do pacote que pode ser transmitido por um dos nós de encaminhamento entre os computadores local e remoto, o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para PacketTooBig.

Use esta Ttl propriedade para especificar o número máximo de vezes que a mensagem de eco ICMP pode ser encaminhada antes de chegar ao seu destino. Se o pacote não chegar ao seu destino após ser encaminhado o número de vezes especificado, o pacote é descartado e o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para TtlExpired.

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

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

Devoluções

Um PingReply objeto que fornece informação sobre a mensagem de resposta eco ICMP, caso uma tenha sido recebida, ou fornece a razão da falha se nenhuma mensagem foi recebida.

Exceções

Exemplos

Para um exemplo que demonstra como chamar uma Send sobrecarga, veja a visão geral da Ping classe.

Observações

Se a mensagem de resposta de eco ICMP não for recebida dentro do tempo especificado no timeout parâmetro, o eco ICMP falha e a Status propriedade é definida para TimedOut.

Esta sobrecarga utiliza as definições padrão para fragmentação e encaminhamento de pacotes. O pacote que contém a mensagem de eco ICMP pode ser fragmentado em trânsito se o tamanho total do pacote exceder o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos. Para evitar fragmentação, use um dos Send métodos que toma um options parâmetro e defina a DontFragment propriedade para true. Quando DontFragment é true e o tamanho total do pacote excede o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos, o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para PacketTooBig.

Os pacotes ou fragmentos de pacotes podem ser encaminhados encaminhando nós 128 vezes antes de serem descartados. Para alterar esta definição, use uma Send sobrecarga que tome um options parâmetro e defina a Ttl propriedade para o valor desejado. Se o pacote não chegar ao seu destino após ser encaminhado o número de vezes especificado, o pacote é descartado e o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para TtlExpired.

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

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

Devoluções

Um PingReply objeto que fornece informação sobre a mensagem de resposta eco ICMP, caso tenha sido recebida, ou que fornece a razão da falha, caso nenhuma mensagem tenha sido recebida. O método retorna PacketTooBig se o pacote exceder a Unidade Máxima de Transmissão (MTU).

Exceções

Exemplos

O seguinte exemplo de código demonstra como chamar este método.

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

Observações

Se a mensagem de resposta de eco ICMP não for recebida dentro do tempo especificado no timeout parâmetro, o eco ICMP falha e a Status propriedade é definida para TimedOut.

Esta sobrecarga utiliza as definições padrão para fragmentação e encaminhamento de pacotes. O pacote que contém a mensagem de eco ICMP pode ser fragmentado em trânsito se o tamanho total do pacote exceder o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos. Para evitar fragmentação, use um dos Send métodos que toma um options parâmetro e defina a DontFragment propriedade para true. Quando DontFragment é true e o tamanho total do pacote excede o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos, o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para PacketTooBig.

Os pacotes ou fragmentos de pacotes podem ser encaminhados encaminhando nós 128 vezes antes de serem descartados. Para alterar esta definição, use uma Send sobrecarga que tome um options parâmetro e defina a Ttl propriedade para o valor desejado. Se o pacote não chegar ao seu destino após ser encaminhado o número de vezes especificado, o pacote é descartado e o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para TtlExpired.

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

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

Devoluções

Um PingReply objeto que fornece informação sobre a mensagem de resposta eco ICMP, caso uma tenha sido recebida, ou fornece a razão da falha se nenhuma mensagem foi recebida.

Exceções

Exemplos

Para um exemplo que demonstra como chamar um Send método, veja a Ping visão geral da classe.

Observações

Se a mensagem de resposta de eco ICMP não for recebida dentro do tempo especificado no timeout parâmetro, o eco ICMP falha e a Status propriedade é definida para TimedOut.

Esta sobrecarga utiliza as definições padrão para fragmentação e encaminhamento de pacotes. O pacote que contém a mensagem de eco ICMP pode ser fragmentado em trânsito se o tamanho total do pacote exceder o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos. Para evitar fragmentação, use um dos Send métodos que toma um options parâmetro e defina a DontFragment propriedade para true. Quando DontFragment é true e o tamanho total do pacote excede o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos, o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para PacketTooBig. Os pacotes ou fragmentos de pacotes (se fragmentados) podem ser encaminhados ao encaminhar os nós 128 vezes antes de serem descartados. Para alterar esta definição, use uma Send sobrecarga que tome um options parâmetro e defina a Ttl propriedade para o valor desejado. Se o pacote não chegar ao seu destino após ser encaminhado o número de vezes especificado, o pacote é descartado e o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para TtlExpired.

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

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

Devoluções

Um PingReply objeto que fornece informação sobre a mensagem de resposta eco ICMP, caso uma tenha sido recebida, ou fornece a razão da falha se nenhuma mensagem foi recebida.

Exceções

Exemplos

Para um exemplo que demonstra como chamar um Send método, veja a Ping visão geral da classe.

Observações

Se a mensagem de resposta de eco ICMP não for recebida dentro do tempo especificado no timeout parâmetro, o eco ICMP falha e a Status propriedade é definida para TimedOut.

Esta sobrecarga utiliza as definições padrão para fragmentação e encaminhamento de pacotes. O pacote que contém a mensagem de eco ICMP pode ser fragmentado em trânsito se o tamanho total do pacote exceder o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos. Para evitar fragmentação, use um dos Send métodos que toma um options parâmetro e defina a DontFragment propriedade para true. Quando DontFragment é true e o tamanho total do pacote excede o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos, o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para PacketTooBig.

Os pacotes ou fragmentos de pacotes podem ser encaminhados encaminhando nós 128 vezes antes de serem descartados. Para alterar esta definição, use uma Send sobrecarga que tome um options parâmetro e defina a Ttl propriedade para o valor desejado. Se o pacote não chegar ao seu destino após ser encaminhado o número de vezes especificado, o pacote é descartado e o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para TtlExpired.

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

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

Devoluções

Um PingReply objeto que fornece informação sobre a mensagem de resposta eco ICMP, caso tenha sido recebida, ou que fornece a razão da falha, caso nenhuma mensagem tenha sido recebida.

Exceções

Exemplos

O exemplo de código seguinte demonstra como chamar este método.

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

Observações

Este método envia um buffer de 32 Byte dados com a mensagem de eco ICMP. O método espera cinco segundos por uma mensagem de resposta de eco ICMP. Se não receber resposta nesse tempo, o método devolve e a Status propriedade é definida para TimedOut.

Esta sobrecarga utiliza as definições padrão para fragmentação e encaminhamento de pacotes. O pacote que contém a mensagem de eco ICMP pode ser fragmentado em trânsito se o tamanho total do pacote exceder o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos. Para evitar fragmentação, use um dos Send métodos que toma um options parâmetro e defina a DontFragment propriedade para true. Quando DontFragment é true e o tamanho total do pacote excede o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos, o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para PacketTooBig. Os pacotes ou fragmentos de pacotes (se fragmentados) podem ser encaminhados ao encaminhar os nós 128 vezes antes de serem descartados. Para alterar esta definição, use uma Send sobrecarga que tome um options parâmetro e defina a Ttl propriedade para o valor desejado. Se o pacote não chegar ao seu destino após ser encaminhado o número de vezes especificado, o pacote é descartado e o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para TtlExpired.

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

Origem:

Ping.cs

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

Devoluções

Um PingReply objeto que fornece informação sobre a mensagem de resposta eco ICMP, caso tenha sido recebida, ou que descreva a razão da falha caso nenhuma mensagem tenha sido recebida.

Exceções

Exemplos

O exemplo de código seguinte demonstra como chamar este método.

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

Observações

Este método envia para o host que é especificado por address um buffer de 32 Byte dados com a mensagem de eco ICMP. O método espera cinco segundos por uma mensagem de resposta de eco ICMP. Se não receber resposta nesse tempo, o método devolve e a Status propriedade é definida para TimedOut.

Esta sobrecarga utiliza as definições padrão para fragmentação e encaminhamento de pacotes. O pacote que contém a mensagem de eco ICMP pode ser fragmentado em trânsito se o tamanho total do pacote exceder o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos. Para evitar fragmentação, use um dos Send métodos que toma um options parâmetro e defina a DontFragment propriedade para true. Quando DontFragment é true e o tamanho total do pacote excede o tamanho máximo que pode ser transmitido por um dos nós de encaminhamento entre os computadores locais e remotos, o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para PacketTooBig. Os pacotes ou fragmentos de pacotes (se fragmentados) podem ser encaminhados ao encaminhar os nós 128 vezes antes de serem descartados. Para alterar esta definição, use uma Send sobrecarga que tome um options parâmetro e defina a Ttl propriedade para o valor desejado. Se o pacote não chegar ao seu destino após ser encaminhado o número de vezes especificado, o pacote é descartado e o pedido de eco ICMP falha. Quando isto acontece, o Status é definido para TtlExpired.