StreamSocketControl 类

定义

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

继承

Object Platform::Object IInspectable StreamSocketControl

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

注解

StreamSocketControl 类提供对 StreamSocket 对象上高级套接字控制数据的访问权限。

StreamSocketControl 对象是使用父 StreamSocket 对象自动创建的。 StreamSocket.Control 属性提供对关联的 StreamSocketControl 对象的访问。

在连接 StreamSocket 之前，必须设置对 StreamSocketControl 上的属性值所做的任何更改。 因此，如果需要更改 ClientCertificate、IgnorableServerCertificateErrors、KeepAlive、NoDelay、OutboundBufferSizeInBytes 、OutboundUnicastHopLimit 或 QualityOfService 属性，则这些更改必须在成功调用 StreamSocket 上的 ConnectAsync 方法之一之前发生。

使用 ClientCertificate 设置客户端证书，以用于通过关联的 StreamSocket 对象建立安全连接。

以下示例创建 StreamSocket，然后演示如何将 NoDelay 属性设置为 false。 其他属性可能以类似的方式设置。 完成此操作后，应用可以连接 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.

有关使用 StreamSocketControl 的详细信息，请参阅 如何使用高级套接字控件。

版本历史记录

属性

适用于

另请参阅

• StreamSocket
• Control
• DatagramSocketInformation
• 使用套接字进行连接
• 如何使用高级套接字控件
• ControlChannelTrigger StreamSocket 示例
• StreamSocket 示例