SerialPort.ReadByte メソッド

定義

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

public:
 int ReadByte();
public int ReadByte ();
member this.ReadByte : unit -> int
Public Function ReadByte () As Integer

戻り値

Int32 にキャストしたバイト。または、ストリームの末尾が読み取られた場合は -1。

例外

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

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

- または -

バイトが読み取られませんでした。

注釈

このメソッドは 1 バイトを読み取ります。

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

注意

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

適用対象