StreamSocketControl.SerializeConnectionAttempts Eigenschaft

Definition

Namespace:

Windows.Networking.Sockets

Ein -Wert, der angibt, ob die Versuche parallel oder seriell durchgeführt werden, wenn mehrere Verbindungsversuche durchgeführt werden.

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

Eigenschaftswert

Boolean

bool

Bei "true" ist in diesem StreamSocket höchstens ein Verbindungsversuch gleichzeitig aktiv. Der Standardwert ist „false“.

Hinweise

Unter bestimmten Umständen versucht die Windows-Runtime möglicherweise, eine Verbindung mit mehreren Methoden parallel herzustellen. Wenn StreamSocket beispielsweise versucht, eine Verbindung herzustellen und ein Proxy im Netzwerk erkannt wird, versucht es sowohl eine direkte Verbindung mit der angegebenen IP-Adresse als auch eine HTTP CONNECT-Anforderung (die über den Proxy eine Verbindung herstellt). Die erste erfolgreiche Verbindung ist die, die vom StreamSocket-Objekt verwendet wird. Obwohl dies in den meisten Fällen gut funktioniert, verursacht dies Probleme mit einigen Servern, wenn beide Verbindungsversuche erfolgreich sind. Wenn Ihre App StreamSocket verwendet, um eine Verbindung mit einem Server herzustellen, bei dem die parallele Verbindungsmethode Probleme auf dem Server verursacht, sollten Sie SerializeConnectionAttempts auf true festlegen, bevor Sie eine Verbindung herstellen. Dadurch wird sichergestellt, dass zu einem bestimmten Zeitpunkt höchstens ein TCP-Verbindungsversuch ausgeführt wird und dass nur eine einzige Verbindung verwendet wird.

Ihr Code muss diese Eigenschaft festlegen, bevor Sie ConnectAsync aufrufen, um eine Verbindung herzustellen. Wenn Sie diesen Eigenschaftswert ändern, nachdem ConnectAsync aufgerufen wurde, wird eine Ausnahme ausgelöst.

Beachten Sie, dass das Serialisieren der Verbindungslogik dazu führen kann, dass das Herstellen der Verbindung länger dauert.