StreamSocketListener Class

TCP ストリーム ソケットまたは Bluetooth RFCOMM を使用して受信ネットワーク接続を待機できるようにします。

構文


var streamSocketListener = new Windows.Networking.Sockets.StreamSocketListener();

属性

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

メンバー

StreamSocketListenerクラス には次の種類のメンバーがあります。

コンストラクター

StreamSocketListenerクラス にはこれらのコンストラクターがあります。

コンストラクター説明
StreamSocketListener Creates a new StreamSocketListener object.

 

イベント

StreamSocketListenerクラス にはこれらのイベントがあります。

イベント説明
ConnectionReceived An event that indicates that a connection was received on the StreamSocketListener object.

 

メソッド

The StreamSocketListener クラス には次のメソッドがあります。 With C#、Visual Basic、および C++ では、以下からもメソッドが継承されます。Object クラス.

メソッド説明
BindEndpointAsync Starts a bind operation on a StreamSocketListener to a local hostname and a local service name.
BindServiceNameAsync(String) Starts a bind operation on a StreamSocketListener to a local service name.
BindServiceNameAsync(String, SocketProtectionLevel) Starts a bind operation on a StreamSocketListener to a local service name with a specified SocketProtectionLevel to set on any bound sockets.
BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) Starts a socket bind operation on a StreamSocketListener to a local service name on a specified network adapter with a specified SocketProtectionLevel to set on any bound sockets.
Close [C++, JavaScript]Closes the StreamSocketListener object.
Dispose [C#, VB]Performs tasks associated with freeing, releasing, or resetting unmanaged resources.

 

プロパティ

StreamSocketListenerクラス には次のプロパティがあります。

プロパティアクセスの種類説明

Control

読み取り専用Gets socket control data on a StreamSocketListener object.

Information

読み取り専用Gets socket information for the StreamSocketListener object.

 

解説

StreamSocketListener クラスは、TCP ストリーム ソケットを使用した受信ネットワーク接続の待機と接続の受け入れをサポートしています。

操作の一般的な順序は次のとおりです。

  • StreamSocketListener を作成します。
  • Control プロパティを使用して、StreamSocketListenerControl オブジェクトを取得し、必要なソケットのサービス品質を設定します。
  • ConnectionReceived イベントをイベント ハンドラーに割り当てます。
  • BindServiceNameAsync または BindEndpointAsync メソッドを呼び出して、ローカル TCP ポートまたはサービス名に束縛します。
  • 接続が受信されると、StreamSocketListenerConnectionReceivedEventArgs オブジェクトを使用して、作成された StreamSocket オブジェクトを持つ Socket プロパティを取得します。
  • StreamSocket オブジェクトを使用して、データを送受信します。
  • Close メソッドを呼び出して、受信ネットワーク接続を待機して受け入れるのを停止し、StreamSocketListener オブジェクトに関連するすべてのアンマネージ リソースを解放します。接続が受信されると作成される StreamSocket オブジェクトは、影響を受けず、必要に応じて使用し続けることができます。

例外処理

StreamSocketListener クラスに対して非同期メソッドを呼び出す場合は、例外を処理するコードを記述する必要があります。 パラメーターの検証エラー、名前解決の失敗、およびネットワーク エラーによって例外が発生することがあります。ネットワーク エラー (接続の喪失、接続の失敗、サーバー障害など) による例外は、いつでも発生する可能性があります。 これらのエラーが発生すると、例外がスローされます。例外がアプリで処理されない場合は、ランタイムによってアプリ全体が終了することがあります。

Windows.Networking.Sockets 名前空間には、ソケットを使用するときにエラーを処理するための便利なヘルパー メソッドと列挙体があります。これは、アプリによって異なる特定のネットワーク例外の処理に役立つ場合があります。アプリは、パラメーター検証エラーの例外から HRESULT を使用して、例外の原因となったエラーの詳細情報を得ることもできます。

発生する可能性がある例外と例外を処理する方法の詳細については、「Handling exceptions in network apps (ネットワーク アプリでの例外の処理)」を参照してください。

Windows Server 2012 での StreamSocketListener の使用

Windows Server 2012 および Windows Server 2012 R2 では、メディア ファンデーション機能が有効になっていない場合、Windows.Networking.Sockets 名前空間のほとんどのクラスを実装する Windows.Networking.dll は読み込まれません。その結果、Windows.Networking.Sockets 名前空間で StreamSocketListener と関連ソケット クラスを使用するアプリは、メディア ファンデーション機能が無効な場合、失敗します。Windows Server 2012 または Windows Server 2012 R2 は、メディア ファンデーション機能が無効の設定でインストールされます。

メディア ファンデーション機能は、 Windows Server 2012 または Windows Server 2012 R2 でサーバー マネージャーを使用するか、コマンド プロンプトに次のテキストまたはスクリプトを入力することによって有効にできます。

dism /online /enable-feature /featurename:ServerMediaFoundation

メディア ファンデーション機能が有効にされると、再起動するように求められます。コンピューターを再起動すると、ソケットと WebSocket を扱う Windows.Networking.Sockets 名前空間のクラスが期待どおりに機能します。

要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリ, デスクトップ アプリ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリ, デスクトップ アプリ]

最小限サポートされる携帯電話

Windows Phone 8

名前空間

Windows.Networking.Sockets
Windows::Networking::Sockets [C++]

メタデータ

Windows.winmd

DLL

Windows.Networking.dll

Capabilities

internetClientServer
privateNetworkClientServer
ID_CAP_NETWORKING [Windows Phone]

参照

その他のリソース
ネットワーク サービスへの接続 (JavaScript および HTML を使用した Windows ストア アプリ)
ネットワーク サービスへの接続 (C#/VB/C++ および XAML を使用した Windows ストア アプリ)
ネットワーク アプリでの例外の処理
高度なソケット コントロールの使用方法 (JavaScript および HTML を使用する Windows ストア アプリ)
高度なソケット コントロールの使用方法 (C#/VB/C++ および XAML を使用する Windows ストア アプリ)
クイック スタート: ストリーム ソケットによるネットワーク リソースへの接続 (JavaScript と HTML を使った Windows Store アプリ)
ネットワーク接続のトラブルシューティングおよびデバッグ
参照
IClosable
Object
StreamSocket
StreamSocketListenerConnectionReceivedEventArgs
StreamSocketListenerControl
StreamSocketListenerInformation

 

 

表示:
© 2014 Microsoft