PingOptions Costruttori

Definizione

Spazio dei nomi:

System.Net.NetworkInformation

Assembly:

System.Net.Ping.dll

Inizializza una nuova istanza della classe PingOptions.

Overload

PingOptions()	Inizializza una nuova istanza della classe PingOptions.
PingOptions(Int32, Boolean)	Inizializza una nuova istanza della classe PingOptions e imposta i valori TTL (Time to Live) e frammentazione.

PingOptions()

Origine:

PingOptions.cs

Inizializza una nuova istanza della classe PingOptions.

public:
 PingOptions();

public PingOptions ();

Public Sub New ()

Esempio

Nell'esempio di codice seguente viene illustrata la chiamata a questo costruttore.

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

Commenti

Nella tabella seguente vengono illustrati i valori delle proprietà iniziali per un'istanza di PingOptions.

Proprietà	Valore iniziale
Ttl	128
DontFragment	false

È possibile impostare le proprietà su nuovi valori prima di chiamare Send o SendAsync.

PingOptions(Int32, Boolean)

Origine:

PingOptions.cs

Inizializza una nuova istanza della classe PingOptions e imposta i valori TTL (Time to Live) e frammentazione.

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)

Parametri

ttl

Int32

Valore Int32 maggiore di zero che specifica quante volte è possibile inoltrare i pacchetti di dati Ping.

dontFragment

Boolean

true per impedire che i dati inviati all'host remoto vengano frammentati; altrimenti, false.

Eccezioni

ArgumentOutOfRangeException

ttl è minore o uguale a zero.

Esempio

Nell'esempio di codice seguente viene illustrata la chiamata a questo costruttore e la visualizzazione dei valori delle proprietà della nuova istanza.

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

Commenti

Il ttl parametro limita il numero di router e gateway che possono inoltrare i dati. Ciò è utile per testare la lunghezza della route tra i computer locali e remoti. Il dontFragment parametro consente di testare l'unità di trasmissione massima (MTU) dei router e dei gateway usati per trasmettere il pacchetto.