StreamSocketControl.SerializeConnectionAttempts Propriété

Définition

Espace de noms:

Windows.Networking.Sockets

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

public:
 property bool SerializeConnectionAttempts { bool get(); void set(bool value); };

bool SerializeConnectionAttempts();

void SerializeConnectionAttempts(bool value);

public bool SerializeConnectionAttempts { get; set; }

var boolean = streamSocketControl.serializeConnectionAttempts;
streamSocketControl.serializeConnectionAttempts = boolean;

Public Property SerializeConnectionAttempts As Boolean

Valeur de propriété

Boolean

bool

Quand la valeur est true, au plus une tentative de connexion est active à la fois sur ce StreamSocket. La valeur par défaut est false.

Remarques

Dans certaines circonstances, le runtime Windows peut tenter d’établir une connexion à l’aide de plusieurs méthodes en parallèle. Par exemple, lorsque StreamSocket tente une connexion et qu’un proxy est détecté sur le réseau, il tente à la fois une connexion directe à l’adresse IP spécifiée et une requête HTTP CONNECT (qui se connecte via le proxy) en parallèle. La première connexion à réussir est celle utilisée par l’objet StreamSocket . Bien que cela fonctionne bien dans la plupart des cas, cela provoque des problèmes avec certains serveurs dans le cas où les deux tentatives de connexion réussissent. Si votre application utilise StreamSocket pour se connecter à un serveur où la méthode de connexion parallèle provoque des problèmes sur le serveur, vous devez définir SerializeConnectionAttempts sur true avant de vous connecter. Cela garantit qu’au plus une tentative de connexion TCP est en cours à un moment donné et qu’une seule connexion est utilisée.

Votre code doit définir cette propriété avant d’appeler ConnectAsync pour tenter de se connecter. La modification de cette valeur de propriété après l’appel de ConnectAsync entraîne la levée d’une exception.

Notez que la sérialisation de la logique de connexion peut rendre l’établissement de la connexion plus long.