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 接続を確立する次のインスタンスで使用することをお勧めします。

• Windows.Web.Http 名前空間の HttpClient クラス。
• .NET Frameworkの System.Net.Http 名前空間の HttpClient クラスと HttpClientHandler クラス。 これらのクラスから派生したカスタム クラスもサポートされています。
• IXMLHTTPRequest2 インターフェイス。 IXMLHTTPRequest2 インターフェイスは、World Wide Web Consortium (W3C) によって発行されたいくつかの作業ドラフトで定義されている XMLHttpRequest オブジェクトの拡張機能です。

ネットワーク アプリに関連するキープアライブ間隔には、いくつかの種類があります。 最も低いレベルでは、アプリは TCP キープアライブ オプションを設定して、クライアント アプリとサーバーの間で TCP キープアライブ パケットを送信し、使用されていない確立された TCP 接続を維持できます。 HttpClient クラスと XMLHttpRequest JavaScript オブジェクトには、TCP キープアライブを有効にするオプションがないため、このオプションは既定で無効になっています。 ControlChannelTrigger クラスを使用してバックグラウンド ネットワーク通知をサポートするには、TCP キープアライブを無効にする必要があります。

ControlChannelTrigger クラスのコンテキストには、影響を与える他の 2 つのキープアライブ間隔があります。

• サーバーのキープアライブ間隔 - これは、アプリが中断されたときに起動される頻度について、アプリがシステムに登録するキープアライブ間隔 (分) を指します。 システムは、このキープアライブ間隔に設定された値に基づいてアプリをウェイクアップします。 この値は、ControlChannelTrigger クラスの ServerKeepAliveIntervalInMinutes プロパティによって表され、ControlChannelTrigger コンストラクターの引数として設定されます。 ネットワーク アプリは通常、アプリが TCP 接続を確立したサーバーの既知の動作に基づいてこれを設定する可能性があるため、この値はサーバーのキープアライブ間隔と見なされます。 たとえば、アプリから 30 分間送信されたデータがない場合、Web サーバーが TCP 接続を切断して切断することがわかっている場合、ネットワーク アプリはこのサーバーのキープアライブ間隔を 25 分に設定できます。
• ネットワーク キープアライブ間隔 - これは、現在のネットワーク状態に基づいて TCP スタック内の低レベルのネットワーク コンポーネントによって維持される内部キープアライブ タイマーを指します。 この値は、TCP 接続をそのまま維持するためにネットワーク中継局が必要とする値を表します。 これらのネットワーク中継局は、ネットワーク プロキシやネットワーク アドレス変換ツールなどのハードウェアとデバイスを表します。 この値は TCP スタック内の低レベルのシステム コンポーネントによって動的に決定されるため、ネットワーク アプリではこの値を設定できません。 ネットワークキープアライブ間隔の内部計算では、サーバーのキープアライブ間隔が考慮されます。 ネットワーク アプリは、ControlChannelTrigger クラスの DecreaseNetworkKeepAliveInterval メソッドを呼び出すことによって、確立された TCP 接続が定期的に切断された場合に、ネットワーク キープアライブ タイマーを減らす必要があることをシステムに示すことができます。

バージョン履歴

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

• IClosable
• SocketActivityTrigger
• Windows.Web.Http
• HttpClient
• ネットワークの基本
• バックグラウンドでのネットワーク通信
• IXMLHTTPRequest2
• System.Net.Http
• System.Net.Http.HttpClient
• System.Net.Http.HttpClientHandler
• バックグラウンド タスクのサンプル