StreamSocketControl Classe

Definição

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

Herança

Object Platform::Object IInspectable StreamSocketControl

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Comentários

A classe StreamSocketControl fornece acesso a dados avançados de controle de soquete em um objeto StreamSocket .

Um objeto StreamSocketControl é criado automaticamente com o objeto StreamSocket pai. A propriedade StreamSocket.Control fornece acesso ao objeto StreamSocketControl associado.

Todas as alterações nos valores de propriedade no StreamSocketControl devem ser definidas antes que o StreamSocket seja conectado. Como resultado, se você precisar fazer alterações nas propriedades ClientCertificate, IgnorableServerCertificateErrors, KeepAlive, NoDelay, OutboundBufferSizeInBytes , OutboundUnicastHopLimit ou QualityOfService , essas alterações deverão ocorrer antes de uma chamada bem-sucedida para um dos métodos ConnectAsync no StreamSocket.

Use o ClientCertificate para definir um certificado de cliente a ser usado para fazer conexões seguras pelo objeto StreamSocket associado.

O exemplo a seguir cria um StreamSocket e demonstra como definir a propriedade NoDelay como false. Outras propriedades podem ser definidas de maneira semelhante. Depois que isso for feito, o aplicativo poderá conectar o 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 obter mais informações sobre como usar StreamSocketControl, consulte Como usar controles de soquete avançados.

Histórico de versão

Propriedades

Aplica-se a

Confira também

• StreamSocket
• Control
• DatagramSocketInformation
• Conectando-se com soquetes
• Como usar controles de soquete avançados
• Exemplo de StreamSocket do ControlChannelTrigger
• Exemplo do StreamSocket