DatagramSocketControl Classe

Definizione

public ref class DatagramSocketControl sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DatagramSocketControl final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DatagramSocketControl

Public NotInheritable Class DatagramSocketControl

Ereditarietà

Object Platform::Object IInspectable DatagramSocketControl

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Commenti

La classe DatagramSocketControl consente di accedere ai dati avanzati del controllo socket in un oggetto DatagramSocket .

Un oggetto DatagramSocketControl viene creato automaticamente con l'oggetto DatagramSocket padre. La proprietà DatagramSocket.Control consente di accedere all'oggetto DatagramSocketControl associato.

La proprietà OutboundUnicastHopLimit può essere impostata prima o dopo l'associazione o la connessione di DatagramSocket . Prima di modificare questo valore in un oggetto DatagramSocket associato o connesso, tutti i pacchetti in uscita devono essere scaricati per assicurarsi che tutti i dati scritti in precedenza vengano inviati con il limite di hop precedente.

Eventuali modifiche apportate agli altri valori di proprietà in DatagramSocketControl devono essere impostate prima che datagramSocket sia associato o connesso. Di conseguenza, se è necessario apportare modifiche alle proprietà DontFragment, InboundBufferSizeInBytes o QualityOfService , queste modifiche devono verificarsi prima di una chiamata corretta a BindEndpointAsync, BindServiceNameAsync o uno dei metodi ConnectAsync in DatagramSocket.

Nell'esempio seguente viene creato un oggetto DatagramSocket e viene illustrato come impostare la proprietà QualityOfService su LowLatency. Altre proprietà possono essere impostate in modo simile. Al termine, l'app può connettere DatagramSocket o inviare dati sul socket.

using Windows.Networking.Sockets;

DatagramSocket clientSocket = new DatagramSocket();

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
var currentSetting = clientSocket.Control.QualityOfService;

// Set QualityOfService to LowLatency.
clientSocket.Control.QualityOfService = SocketQualityOfService.LowLatency;

// Now you can call the ConnectAsync method to connect the DatagramSocket.

#include <winrt/Windows.Networking.Sockets.h>
using namespace winrt;
...
Windows::Networking::Sockets::DatagramSocket clientSocket;

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
auto currentSetting{ clientSocket.Control().QualityOfService() };

// Set QualityOfService to LowLatency.
clientSocket.Control().QualityOfService(Windows::Networking::Sockets::SocketQualityOfService::LowLatency);

// Now you can call the ConnectAsync function to connect the DatagramSocket.

using namespace Windows::Networking::Sockets;

DatagramSocket^ clientSocket = ref new DatagramSocket();

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
auto currentSetting = clientSocket->Control->QualityOfService;

// Set QualityOfService to LowLatency.
clientSocket->Control->QualityOfService = SocketQualityOfService::LowLatency;

// Now you can call the ConnectAsync method to connect the DatagramSocket.

Per altre informazioni sull'uso di DatagramSocketControl, vedere Come usare controlli socket avanzati.

Vedi anche

• DatagramSocket
• Control
• DatagramSocketInformation
• Come usare controlli socket avanzati
• Esempio di DatagramSocket
• Esempio di DatagramSocket