SerialPort.DataReceived イベント

.NET Framework クラス ライブラリ リファレンス

SerialPort.DataReceived イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

SerialPort オブジェクトのデータ受信イベントを処理するメソッドを表します。

名前空間: System.IO.Ports
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Event DataReceived As
 SerialDataReceivedEventHandler

Visual Basic (使用法)

Dim instance As SerialPort
Dim handler As SerialDataReceivedEventHandler

AddHandler instance.DataReceived, handler

C#

public event SerialDataReceivedEventHandler DataReceived

C++

public:
event SerialDataReceivedEventHandler^ DataReceived {
    void add (SerialDataReceivedEventHandler^ value);
    void remove (SerialDataReceivedEventHandler^ value);
}

J#

/** @event */
public void add_DataReceived (SerialDataReceivedEventHandler
 value)

/** @event */
public void remove_DataReceived (SerialDataReceivedEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

シリアル受信イベントは、SerialData 列挙体のアイテムによって発生させることができます。このイベントが発生するかどうかはオペレーティング システムによって決定されるため、すべてのパリティ エラーが報告されるわけではありません。

PinChanged、DataReceived、および ErrorReceived の各イベントは、正しい順序で呼び出されない場合があります。また、基本ストリームからエラーが報告されてからイベント ハンドラが実行されるまでに、わずかな遅延が生じる場合があります。一度に実行できるイベント ハンドラは 1 つだけです。

DataReceived イベントは、データが SerialPort オブジェクトから受信されたときにセカンダリ スレッドで発生します。このイベントは、メイン スレッドではなくセカンダリ スレッドで発生するため、メイン スレッド内の一部の要素 (UI 要素など) を変更しようとすると、スレッドの例外が発生する可能性があります。メインの Form または Control で要素を変更する必要がある場合は、Invoke を使用して変更要求をポストバックします。これにより、適切なスレッドで処理が実行されるようになります。

イベント処理の詳細については、「イベントの利用」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
SerialPort クラス
SerialPort メンバ
System.IO.Ports 名前空間