PingOptions Construtores

Definição

Namespace:

System.Net.NetworkInformation

Assembly:

System.Net.Ping.dll

Inicializa uma nova instância da classe PingOptions.

Sobrecargas

PingOptions()	Inicializa uma nova instância da classe PingOptions.
PingOptions(Int32, Boolean)	Inicializa uma nova instância da classe PingOptions e define os valores de fragmentação e vida útil.

PingOptions()

Origem:

PingOptions.cs

Inicializa uma nova instância da classe PingOptions.

public:
 PingOptions();

public PingOptions ();

Public Sub New ()

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

Ping ^ pingSender = gcnew Ping;
PingOptions ^ options = gcnew PingOptions;

// Use the default Ttl value which is 128,
// but change the fragmentation behavior.
options->DontFragment = true;

Ping pingSender = new Ping ();
PingOptions options = new PingOptions ();

// Use the default Ttl value which is 128,
// but change the fragmentation behavior.
options.DontFragment = true;

let pingSender = new Ping()

// Use the default Ttl value which is 128,
// but change the fragmentation behavior.
let options = PingOptions()
options.DontFragment <- true

Comentários

A tabela a seguir mostra os valores de propriedade iniciais de uma instância do PingOptions.

Propriedade	Valor inicial
Ttl	128
DontFragment	false

Você pode definir as propriedades como novos valores antes de chamar Send ou SendAsync.

PingOptions(Int32, Boolean)

Origem:

PingOptions.cs

Inicializa uma nova instância da classe PingOptions e define os valores de fragmentação e vida útil.

public:
 PingOptions(int ttl, bool dontFragment);

public PingOptions (int ttl, bool dontFragment);

new System.Net.NetworkInformation.PingOptions : int * bool -> System.Net.NetworkInformation.PingOptions

Public Sub New (ttl As Integer, dontFragment As Boolean)

Parâmetros

ttl

Int32

Um valor Int32 maior que zero que especifica o número de vezes que os pacotes de dados Ping podem ser encaminhados.

dontFragment

Boolean

true para impedir que os dados enviados ao host remoto sejam fragmentados; caso contrário, false.

Exceções

ArgumentOutOfRangeException

ttl é menor que ou igual a zero.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor e a exibição dos valores de propriedade da nova instância.

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

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

Comentários

O ttl parâmetro limita o número de roteadores e gateways que podem encaminhar os dados. Isso é útil para testar o comprimento da rota entre os computadores locais e remotos. O dontFragment parâmetro permite testar a MTU (unidade de transmissão máxima) dos roteadores e gateways usados para transmitir o pacote.