SerialPort.PinChanged イベント

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

SerialPort.PinChanged イベント

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

SerialPort オブジェクトのシリアル ピン変更イベントを処理するメソッドを表します。

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

Visual Basic (宣言)

Public Event PinChanged As
 SerialPinChangedEventHandler

Visual Basic (使用法)

Dim instance As SerialPort
Dim handler As SerialPinChangedEventHandler

AddHandler instance.PinChanged, handler

C#

public event SerialPinChangedEventHandler PinChanged

C++

public:
event SerialPinChangedEventHandler^ PinChanged {
    void add (SerialPinChangedEventHandler^ value);
    void remove (SerialPinChangedEventHandler^ value);
}

J#

/** @event */
public void add_PinChanged (SerialPinChangedEventHandler
 value)

/** @event */
public void remove_PinChanged (SerialPinChangedEventHandler
 value)

JScript

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

解説

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

PinChanged イベントは、ポートが BreakState を解除したときではなく、SerialPort オブジェクトが BreakState に入ったときに発生します。この動作は、SerialPinChange 列挙体の他の値には適用されません。

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

PinChanged イベントは、セカンダリ スレッドで発生します。このイベントは、メイン スレッドではなくセカンダリ スレッドで発生するため、メイン スレッド内の一部の要素 (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 名前空間