StreamSocketControl Classe

Définition

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

Héritage

Object Platform::Object IInspectable StreamSocketControl

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Remarques

La classe StreamSocketControl permet d’accéder aux données avancées du contrôle de socket sur un objet StreamSocket .

Un objet StreamSocketControl est créé automatiquement avec l’objet StreamSocket parent. La propriété StreamSocket.Control permet d’accéder à l’objet StreamSocketControl associé.

Toute modification apportée aux valeurs de propriété sur StreamSocketControl doit être définie avant que streamSocket ne soit connecté. Par conséquent, si vous devez apporter des modifications aux propriétés ClientCertificate, IgnorableServerCertificateErrors, KeepAlive, NoDelay, OutboundBufferSizeInBytes , OutboundUnicastHopLimit ou QualityOfService , ces modifications doivent se produire avant un appel réussi à l’une des méthodes ConnectAsync sur streamSocket.

Utilisez ClientCertificate pour définir un certificat client à utiliser pour établir des connexions sécurisées sur l’objet StreamSocket associé.

L’exemple suivant crée un StreamSocket, puis montre comment définir la propriété NoDelay sur false. D’autres propriétés peuvent être définies de la même manière. Une fois cette opération effectuée, l’application peut connecter 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.

Pour plus d’informations sur l’utilisation de StreamSocketControl, consultez Utilisation des contrôles de socket avancés.

Historique des versions

Propriétés

S’applique à

Voir aussi

• StreamSocket
• Control
• DatagramSocketInformation
• Connexion avec des sockets
• Comment utiliser des contrôles de socket avancés
• Exemple ControlChannelTrigger StreamSocket
• Exemple StreamSocket