SerialPort.ErrorReceived イベント

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

SerialPort.ErrorReceived イベント

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

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

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

Visual Basic (宣言)

Public Event ErrorReceived As
 SerialErrorReceivedEventHandler

Visual Basic (使用法)

Dim instance As SerialPort
Dim handler As SerialErrorReceivedEventHandler

AddHandler instance.ErrorReceived, handler

C#

public event SerialErrorReceivedEventHandler ErrorReceived

C++

public:
event SerialErrorReceivedEventHandler^ ErrorReceived {
    void add (SerialErrorReceivedEventHandler^ value);
    void remove (SerialErrorReceivedEventHandler^ value);
}

J#

/** @event */
public void add_ErrorReceived (SerialErrorReceivedEventHandler
 value)

/** @event */
public void remove_ErrorReceived (SerialErrorReceivedEventHandler
 value)

JScript

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

解説

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

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

ストリームの末尾のバイトでパリティ エラーが発生すると、値 126 を持つ 1 バイトが入力バッファに追加されます。

ErrorReceived イベントは、エラーが 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 名前空間