StreamSocketListenerControl Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des données de contrôle de socket sur un objet StreamSocketListener .
public ref class StreamSocketListenerControl sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class StreamSocketListenerControl final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class StreamSocketListenerControlPublic NotInheritable Class StreamSocketListenerControl- Héritage
- 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 |
ID_CAP_NETWORKING [Windows Phone]
|
Remarques
La classe StreamSocketListenerControl permet d’accéder aux données de contrôle de socket avancées sur un objet StreamSocketListener .
Un objet StreamSocketListenerControl est créé automatiquement avec l’objet StreamSocketListener parent. La propriété StreamSocketListener.Control permet d’accéder à l’objet StreamSocketListenerControl associé.
Toutes les modifications apportées aux valeurs de propriété StreamSocketListenerControl doivent être définies avant que le StreamSocketListener soit lié. Les modifications apportées à la propriété QualityOfService doivent donc être définies avant que la méthode BindServiceNameAsync ou BindEndpointAsync soit appelée sur le StreamSocketListener.
L’exemple suivant crée un StreamSocketListener, puis montre comment définir la propriété QualityOfService sur LowLatency. Une fois cette opération effectuée, l’application peut lier et écouter le StreamSocketListener.
using Windows.Networking.Sockets;
StreamSocketListener listenerSocket = new StreamSocketListener();
// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
var currentSetting = listenerSocket.Control.QualityOfService;
// Set QualityOfService to LowLatency.
listenerSocket.Control.QualityOfService = SocketQualityOfService.LowLatency;
// Now you can call the BindServiceNameAsync or BindEndpointAsync method to listen for connections.
#include <winrt/Windows.Networking.Sockets.h>
using namespace winrt;
...
Windows::Networking::Sockets::StreamSocketListener listenerSocket;
// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
auto currentSetting{ listenerSocket.Control().QualityOfService() };
// Set QualityOfService to LowLatency.
listenerSocket.Control().QualityOfService(Windows::Networking::Sockets::SocketQualityOfService::LowLatency);
// Now you can call the BindServiceNameAsync or BindEndpointAsync method to listen for connections.
using namespace Windows::Networking::Sockets;
StreamSocketListener^ listenerSocket = ref new StreamSocketListener();
// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
auto currentSetting = listenerSocket->Control->QualityOfService;
// Set QualityOfService to LowLatency.
listenerSocket->Control->QualityOfService = SocketQualityOfService::LowLatency;
// Now you can call the BindServiceNameAsync or BindEndpointAsync method to listen for connections.
Pour plus d’informations sur l’utilisation de StreamSocketListenerControl, consultez Utilisation des contrôles de socket avancés.
Propriétés
| KeepAlive |
Valeur qui indique si les paquets keep-alive doivent être envoyés sur un objet StreamSocket créé lorsqu’une connexion est reçue par l’objet StreamSocketListener . |
| NoDelay |
Valeur qui indique si l’algorithme Nagle est utilisé sur un objet StreamSocket créé lorsqu’une connexion est reçue par l’objet StreamSocketListener . |
| OutboundBufferSizeInBytes |
Taille, en octets, de la mémoire tampon d’envoi à utiliser pour l’envoi de données sur un objet StreamSocket créé lorsqu’une connexion est reçue par l’objet StreamSocketListener . |
| OutboundUnicastHopLimit |
Limite de tronçon sur un paquet sortant envoyé à une adresse IP unicast par l’objet StreamSocket créé lorsqu’une connexion est reçue par l’objet StreamSocketListener . |
| QualityOfService |
Qualité de service à définir sur un objet StreamSocket créé lorsqu’une connexion est reçue par l’objet StreamSocketListener . |