SerialPort.ReadChar メソッド

定義

名前空間:

System.IO.Ports

アセンブリ:

System.IO.Ports.dll

パッケージ:

System.IO.Ports v8.0.0

ソース:

SerialPort.cs

SerialPort の入力バッファーから、同期で 1 文字を読み取ります。

public:
 int ReadChar();

public int ReadChar ();

member this.ReadChar : unit -> int

Public Function ReadChar () As Integer

戻り値

Int32

読み取られた文字。

例外

InvalidOperationException

指定したポートが開いていません。

TimeoutException

タイムアウト時間内に操作が完了しませんでした。

- または -

割り当てられたタイムアウト時間内に使用できる文字がありませんでした。

注釈

このメソッドは、エンコードに基づいて 1 つの完全な文字を読み取ります。

と を一緒に使用ReadByteReadCharする場合は注意が必要です。 バイトの読み取りと文字の読み取りを切り替えると、余分なデータが読み取られたり、他の意図しない動作が発生したりする可能性があります。 テキストの読み取りとストリームからのバイナリ データの読み取りを切り替える必要がある場合は、手動でバイトを読み取る、データをデコードするなど、テキストとバイナリ データの境界を慎重に定義するプロトコルを選択します。

注意

クラスはデータを SerialPort バッファーに格納し、 プロパティに BaseStream 含まれるストリームはバッファーに含まれていないため、読み取り可能なバイト数に関して 2 つのデータが競合する可能性があります。 プロパティはBytesToRead、読み取るバイトがあることを示すことができますが、これらのバイトは、 クラスにバッファーSerialPortされているため、 プロパティにBaseStream含まれるストリームからアクセスできない可能性があります。