Compartilhar via


StreamSocketListenerControl Classe

Definição

Fornece dados de controle de soquete em um objeto StreamSocketListener .

public ref class StreamSocketListenerControl sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class StreamSocketListenerControl final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class StreamSocketListenerControl
Public NotInheritable Class StreamSocketListenerControl
Herança
Object Platform::Object IInspectable StreamSocketListenerControl
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo
ID_CAP_NETWORKING [Windows Phone]

Comentários

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

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

Todas as alterações nos valores da propriedade StreamSocketListenerControl devem ser definidas antes que StreamSocketListener seja associado. Portanto, as alterações na propriedade QualityOfService devem ser definidas antes que o método BindServiceNameAsync ou BindEndpointAsync seja chamado no StreamSocketListener.

O exemplo a seguir cria um StreamSocketListener e demonstra como definir a propriedade QualityOfService como LowLatency. Depois que isso for feito, o aplicativo poderá associar e escutar no StreamSocketListener.

using Windows.Networking.Sockets;

StreamSocketListener listenerSocket = new StreamSocketListener();

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
var currentSetting = listenerSocket.Control.QualityOfService;

// Set QualityOfService to LowLatency.
listenerSocket.Control.QualityOfService = SocketQualityOfService.LowLatency;

// Now you can call the BindServiceNameAsync or BindEndpointAsync method to listen for connections.
#include <winrt/Windows.Networking.Sockets.h>
using namespace winrt;
...
Windows::Networking::Sockets::StreamSocketListener listenerSocket;

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
auto currentSetting{ listenerSocket.Control().QualityOfService() };

// Set QualityOfService to LowLatency.
listenerSocket.Control().QualityOfService(Windows::Networking::Sockets::SocketQualityOfService::LowLatency);

// Now you can call the BindServiceNameAsync or BindEndpointAsync method to listen for connections.
using namespace Windows::Networking::Sockets;

StreamSocketListener^ listenerSocket = ref new StreamSocketListener();

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
auto currentSetting = listenerSocket->Control->QualityOfService;

// Set QualityOfService to LowLatency.
listenerSocket->Control->QualityOfService = SocketQualityOfService::LowLatency;

// Now you can call the BindServiceNameAsync or BindEndpointAsync method to listen for connections.

Para obter mais informações sobre como usar StreamSocketListenerControl, consulte Como usar controles de soquete avançados.

Propriedades

KeepAlive

Um valor que indica se os pacotes keep alive devem ser enviados em um objeto StreamSocket criado quando uma conexão é recebida pelo objeto StreamSocketListener .

NoDelay

Um valor que indica se o algoritmo Nagle é usado em um objeto StreamSocket criado quando uma conexão é recebida pelo objeto StreamSocketListener .

OutboundBufferSizeInBytes

O tamanho, em bytes, do buffer de envio a ser usado para enviar dados em um objeto StreamSocket criado quando uma conexão é recebida pelo objeto StreamSocketListener .

OutboundUnicastHopLimit

O limite de salto em um pacote de saída enviado para um endereço IP unicast pelo objeto StreamSocket criado quando uma conexão é recebida pelo objeto StreamSocketListener .

QualityOfService

A qualidade do serviço a ser definida em um objeto StreamSocket criado quando uma conexão é recebida pelo objeto StreamSocketListener .

Aplica-se a

Confira também