StreamSocketControl Classe

Definizione

public ref class StreamSocketControl sealed

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

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

Public NotInheritable Class StreamSocketControl

Ereditarietà

Object Platform::Object IInspectable StreamSocketControl

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Commenti

La classe StreamSocketControl consente di accedere ai dati avanzati del controllo socket in un oggetto StreamSocket .

Un oggetto StreamSocketControl viene creato automaticamente con l'oggetto StreamSocket padre. La proprietà StreamSocket.Control fornisce l'accesso all'oggetto StreamSocketControl associato.

Eventuali modifiche ai valori delle proprietà in StreamSocketControl devono essere impostate prima che StreamSocket sia connesso. Di conseguenza, se è necessario apportare modifiche alle proprietà ClientCertificate, IgnorableServerCertificateErrors, KeepAlive, NoDelay, OutboundBufferSizeInBytes , OutboundUnicastHopLimit o QualityOfService , queste modifiche devono verificarsi prima di una chiamata corretta a uno dei metodi ConnectAsync in StreamSocket.

Usare ClientCertificate per impostare un certificato client da usare per stabilire connessioni sicure sull'oggetto StreamSocket associato.

Nell'esempio seguente viene creato un oggetto StreamSocket e viene illustrato come impostare la proprietà NoDelay su false. Altre proprietà possono essere impostate in modo simile. Al termine, l'app può connettere StreamSocket.

using Windows.Networking.Sockets;

StreamSocket clientSocket = new StreamSocket();

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

// Set NoDelay to false so that the Nagle algorithm is not disabled.
clientSocket.Control.NoDelay = false;

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

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

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

// Set NoDelay to false so that the Nagle algorithm is not disabled.
clientSocket.Control().NoDelay(false);

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

using namespace Windows::Networking::Sockets;

StreamSocket^ clientSocket = ref new StreamSocket();

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

// Set NoDelay to false so that the Nagle algorithm is not disabled.
clientSocket->Control->NoDelay = false;

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

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

Cronologia delle versioni

Vedi anche

• StreamSocket
• Control
• DatagramSocketInformation
• Connessione con socket
• Come usare controlli socket avanzati
• Esempio di StreamSocket ControlChannelTrigger
• Esempio di StreamSocket