MessageWebSocketControl Класс

Определение

Пространство имен:

Windows.Networking.Sockets

Предоставляет данные управления сокетом в MessageWebSocket.

public ref class MessageWebSocketControl sealed : IWebSocketControl2

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class MessageWebSocketControl final : IWebSocketControl2

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class MessageWebSocketControl : IWebSocketControl2

Public NotInheritable Class MessageWebSocketControl
Implements IWebSocketControl2

Наследование

Object Platform::Object IInspectable MessageWebSocketControl

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

IWebSocketControl IWebSocketControl2

Требования к Windows

Требования	Описание
Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Класс MessageWebSocketControl предоставляет доступ к данным расширенного управления сокетами в объекте MessageWebSocket .

Объект MessageWebSocketControl автоматически создается с родительским объектом MessageWebSocket . Свойство MessageWebSocket.Control предоставляет доступ к связанному объекту MessageWebSocket .

Свойство SupportedProtocols получает значение этого свойства и может вызываться в любое время.

Свойство MessageType можно изменить в любое время до или после подключения MessageWebSocket . Это позволяет приложению переключаться между двоичными и UTF-8 сообщениями при необходимости.

Свойство OutboundBufferSizeInBytes должно быть задано перед подключением MessageWebSocket . Установка этого свойства после подключения MessageWebSocket не влияет.

Любые изменения других значений свойств в MessageWebSocketControl должны быть заданы перед привязкой или подключением DatagramSocket . В результате, если необходимо внести изменения в свойства MaxMessageSize, ProxyCredential, OutboundBufferSizeInBytes или ServerCredential , эти изменения должны возникать перед успешным вызовом метода ConnectAsync в MessageWebSocket.

В следующем примере создается MessageWebSocket, а затем показано, как задать для свойства MessageWebSocketControl.MessageTypeдвоичное значение. (Другие свойства могут быть заданы аналогичным образом.) После этого приложение может подключить MessageWebSocket.

using Windows.Networking.Sockets;

MessageWebSocket clientWebSocket = new MessageWebSocket();

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

// Set messageType to Binary.
clientWebSocket.Control.MessageType = SocketMessageType.Binary;

// Now you can call the ConnectAsync method to connect the MessageWebSocket.

#include <winrt/Windows.Networking.Sockets.h>
using namespace winrt;
...
Windows::Networking::Sockets::MessageWebSocket clientSocket;

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

// Set QualityOfService to Binary.
clientSocket.Control().MessageType(Windows::Networking::Sockets::SocketMessageType::Binary);

// Now you can call the ConnectAsync function to connect the MessageWebSocket.

using namespace Windows::Networking::Sockets;

MessageWebSocket^ clientWebSocket = ref new MessageWebSocket();

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

// Set messageType to Binary.
clientWebSocket->Control->MessageType = SocketMessageType::Binary;

// Now you can call the ConnectAsync method to connect the MessageWebSocket.

Дополнительные сведения об использовании MessageWebSocketControl см. в статье "Использование расширенных элементов управления WebSocket".

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная ценность
1607	14393	IgnorableServerCertificateErrors
1709	16299	ActualUnsolicitedPongInterval
1709	16299	Сертификат клиента
1709	16299	DesiredUnsolicitedPongInterval
1709	16299	ReceiveMode

Свойства

Имя.	Описание
ActualUnsolicitedPongInterval	Позволяет приложению получить фактический неопрошенный интервал PONG WebSocket.
ClientCertificate	Возвращает сертификат, предоставленный клиентом при установке безопасного подключения WebSocket.
DesiredUnsolicitedPongInterval	Позволяет приложению получать и задавать нужный неопрошенный интервал PONG WebSocket.
IgnorableServerCertificateErrors	Возвращает список ошибок сертификата сервера, игнорируемых. Получите этот список и добавьте значения ChainValidationResult для ошибок сертификата сервера, которые вы хотите игнорировать во время безопасного процесса проверки сертификата сервера WebSocket (wss:// протокола).
MaxMessageSize	Максимальный размер сообщения в байтах для сообщения WebSocket, который необходимо настроить в объекте MessageWebSocket .
MessageType	Тип сообщения WebSocket для настройки объекта MessageWebSocket для операций записи.
OutboundBufferSizeInBytes	Размер буфера отправки в байтах, используемый для отправки данных в объект MessageWebSocket .
ProxyCredential	Учетные данные, используемые для проверки подлинности на прокси-сервере через проверку подлинности заголовка HTTP с помощью объекта MessageWebSocket .
ReceiveMode	Позволяет клиентам управлять получением полных или частичных сообщений.
ServerCredential	Учетные данные, используемые для проверки подлинности на сервере WebSocket с помощью проверки подлинности заголовка HTTP с помощью объекта MessageWebSocket .
SupportedProtocols	Возвращает коллекцию, которую можно использовать для добавления списка поддерживаемых вложенных протоколов, которые будут объявлены серверу во время подтверждения подключения.

См. также

• MessageWebSocket
• Control
• MessageWebSocketInformation
• Использование расширенных элементов управления WebSocket
• WebSockets
• Пример WebSocket