Partager via


StreamSocketControl Classe

Définition

Fournit des données de contrôle de socket sur un objet StreamSocket .

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

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application
bluetooth.rfcomm ID_CAP_NETWORKING [Windows Phone]

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

Version de Windows Version du SDK Valeur ajoutée
1709 16299 MinProtectionLevel

Propriétés

ClientCertificate

Obtient ou définit le certificat SSL/TLS client qui sera envoyé au serveur si le serveur demande un certificat client.

IgnorableServerCertificateErrors

Obtenez un vecteur d’erreurs de serveur SSL à ignorer lors de l’établissement d’une connexion SSL avec un StreamSocket.

KeepAlive

Valeur qui indique si les paquets keep-alive sont envoyés à la destination distante sur un objet StreamSocket .

MinProtectionLevel

Limite la version du protocole TLS qui sera négociée lorsque le développeur utilise les méthodes ConnectAsync() ou UpgradeToSslAsync() qui nécessitent TLS.

NoDelay

Valeur qui indique si l’algorithme Nagle est utilisé sur un objet StreamSocket .

OutboundBufferSizeInBytes

Taille, en octets, de la mémoire tampon d’envoi à utiliser pour envoyer des données sur un objet StreamSocket .

OutboundUnicastHopLimit

Limite de tronçons sur un paquet sortant envoyé à une adresse IP de monodiffusion par l’objet StreamSocket .

QualityOfService

Qualité de service sur un objet StreamSocket .

SerializeConnectionAttempts

Valeur qui indique si, lorsque plusieurs tentatives de connexion sont effectuées, les tentatives sont effectuées en parallèle ou en série.

S’applique à

Voir aussi