ControlChannelTrigger Класс

Определение

public ref class ControlChannelTrigger sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(Windows.Networking.Sockets.IControlChannelTriggerFactory, 65536, Windows.Networking.Sockets.ControlChannelTriggerContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.Sockets.ControlChannelTriggerContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ControlChannelTrigger final : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.Sockets.ControlChannelTriggerContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Networking.Sockets.IControlChannelTriggerFactory, 65536, "Windows.Networking.Sockets.ControlChannelTriggerContract")]
class ControlChannelTrigger final : IClosable

[Windows.Foundation.Metadata.Activatable(typeof(Windows.Networking.Sockets.IControlChannelTriggerFactory), 65536, typeof(Windows.Networking.Sockets.ControlChannelTriggerContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.Sockets.ControlChannelTriggerContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class ControlChannelTrigger : System.IDisposable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.Sockets.ControlChannelTriggerContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Networking.Sockets.IControlChannelTriggerFactory), 65536, "Windows.Networking.Sockets.ControlChannelTriggerContract")]
public sealed class ControlChannelTrigger : System.IDisposable

Public NotInheritable Class ControlChannelTrigger
Implements IDisposable

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

Object Platform::Object IInspectable ControlChannelTrigger

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации

IClosable IDisposable

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

Комментарии

Класс ControlChannelTrigger и связанные интерфейсы позволяют приложению использовать сеть, если приложение не является приложением переднего плана. Универсальное приложение для Windows обычно приостанавливается, когда оно больше не находится в приложении переднего плана и перемещается в фоновый режим. Существуют некоторые исключения из-за приостановки приложения (например, активной печати, доступа к звуковому потоку и передачи файлов в фоновом режиме). Класс ControlChannelTrigger позволяет сетевому приложению, которое установило TCP-подключение, уведомлять систему о том, что установленное сетевое подключение должно оставаться в рабочем состоянии, и система должна разбудить приостановленное приложение при получении сетевых данных для приложения или истечении интервала таймера активности сервера. Используйте триггеры канала управления, когда приложению необходимо поддерживать сетевое подключение, даже если оно находится в фоновом режиме.

Хотя класс ControlChannelTrigger можно использовать с DatagramSocket, StreamSocket или StreamSocketListener, Windows 10 предоставляет улучшенный механизм для приложений, которые используют эти классы и хотят поддерживать подключения в фоновом режиме. Дополнительные сведения о SocketActivityTrigger и брокере сокетов см. в разделе Сетевые подключения в фоновом режиме.

Класс ControlChannelTrigger рекомендуется использовать экземплярами следующих компонентов, устанавливающих TCP-подключение:

• Класс HttpClient в пространстве имен Windows.Web.Http .
• Классы HttpClient и HttpClientHandler в пространстве имен System.Net.Http в платформа .NET Framework. Также поддерживаются пользовательские классы, производные от этих классов.
• Интерфейс IXMLHTTPRequest2 . Интерфейс IXMLHTTPRequest2 является расширением объекта XMLHttpRequest, определенного в нескольких рабочих черновиках, опубликованных консорциумом W3C.

Существует несколько типов интервалов активности, которые могут относиться к сетевым приложениям. На самом низком уровне приложение может задать параметр проверки активности TCP для отправки пакетов tcp-активности между клиентским приложением и сервером для поддержания установленного TCP-подключения, которое не используется. Класс HttpClient и объект XMLHttpRequest JavaScript не имеют возможности включить протокол TCP keep-alive, и этот параметр отключен по умолчанию. Чтобы использовать класс ControlChannelTrigger для поддержки фоновых сетевых уведомлений, необходимо отключить протокол TCP Keep-Alive.

В контексте класса ControlChannelTrigger существуют два других интервала поддержания активности, которые оказывают влияние.

• Интервал поддержания активности сервера — это интервал активности в минутах, который приложение регистрирует в системе, чтобы узнать, как часто должно быть пробуждение после приостановки приложения. Система разбудит приложение на основе значения, заданного для этого интервала активности. Это значение представлено свойством ServerKeepAliveIntervalInMinutes класса ControlChannelTrigger и задается в качестве аргумента конструктора ControlChannelTrigger. Это значение считается интервалом активности сервера, так как сетевое приложение обычно может задать его на основе известного поведения сервера, к которому приложение установило TCP-подключение. Например, если известно, что веб-сервер будет отключаться и удалять TCP-подключения, если приложение не отправляет данные в течение 30 минут, сетевое приложение может установить для этого сервера интервал активности в 25 минут.
• Интервал активности сети — это внутренний таймер активности, поддерживаемый низкоуровневые сетевые компоненты в стеке TCP на основе текущих условий сети. Это значение представляет значение, необходимое сетевым посредникам для сохранения TCP-подключения без изменений. Эти сетевые посредники представляют оборудование и устройства, такие как сетевые прокси-серверы и переводчики сетевых адресов. Сетевое приложение не может задать это значение, так как это значение динамически определяется низкоуровневые системные компоненты в стеке TCP. При внутреннем вычислении интервала активности сети учитывается интервал активности сервера. Сетевое приложение может указать системе, что таймер активности сети должен быть уменьшен, если установленные TCP-подключения регулярно удаляются, путем вызова метода DecreaseNetworkKeepAliveInterval в классе ControlChannelTrigger.

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

Конструкторы

Свойства

Методы

Применяется к

См. также раздел

• IClosable
• SocketActivityTrigger
• Windows.Web.Http
• HttpClient
• Основы работы с сетями
• Передача данных по сети в фоновом режиме
• IXMLHTTPRequest2
• System.Net.Http
• System.Net.Http.HttpClient
• System.Net.Http.HttpClientHandler
• Пример фоновой задачи