StreamSocketControl Clase

Definición

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

Herencia

Object Platform::Object IInspectable StreamSocketControl

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Comentarios

La clase StreamSocketControl proporciona acceso a datos de control de socket avanzados en un objeto StreamSocket .

Un objeto StreamSocketControl se crea automáticamente con el objeto Primario StreamSocket . La propiedad StreamSocket.Control proporciona acceso al objeto StreamSocketControl asociado.

Los cambios en los valores de propiedad de StreamSocketControl deben establecerse antes de que se conecte StreamSocket . Como resultado, si necesita realizar cambios en las propiedades ClientCertificate, IgnorableServerCertificateErrors, KeepAlive, NoDelay, OutboundBufferSizeInBytes , OutboundUnicastHopLimit o QualityOfService , estos cambios deben producirse antes de una llamada correcta a uno de los métodos ConnectAsync en StreamSocket.

Use ClientCertificate para establecer un certificado de cliente que se usará para realizar conexiones seguras a través del objeto StreamSocket asociado.

En el ejemplo siguiente se crea un objeto StreamSocket y, a continuación, se muestra cómo establecer la propiedad NoDelay en false. Otras propiedades se pueden establecer de forma similar. Una vez hecho esto, la aplicación puede conectar 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.

Para obtener más información sobre el uso de StreamSocketControl, consulte Uso de controles de socket avanzados.

Historial de versiones

Consulte también

• StreamSocket
• Control
• DatagramSocketInformation
• Conexión con sockets
• Uso de controles de socket avanzados
• Ejemplo streamSocket de ControlChannelTrigger
• Ejemplo de StreamSocket