StreamSocketControl.SerializeConnectionAttempts Propriété
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.
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é
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.