SerialPort.ReadByte Metode

Definisi

Ruang nama:

System.IO.Ports

Rakitan:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

Sumber:

SerialPort.cs

Secara sinkron membaca satu byte dari SerialPort buffer input.

public:
 int ReadByte();

public int ReadByte ();

member this.ReadByte : unit -> int

Public Function ReadByte () As Integer

Mengembalikan

Int32

Byte, ditransmisikan ke Int32, atau -1 jika akhir aliran telah dibaca.

Pengecualian

InvalidOperationException

Port yang ditentukan tidak terbuka.

TimeoutException

Operasi tidak selesai sebelum periode waktu habis berakhir.

-atau-

Tidak ada byte yang dibaca.

Keterangan

Metode ini membaca satu byte.

Berhati-hatilah saat menggunakan ReadByte dan ReadChar bersama-sama. Beralih antara membaca byte dan membaca karakter dapat menyebabkan data tambahan dibaca dan/atau perilaku lain yang tidak diinginkan. Jika perlu beralih antara membaca teks dan membaca data biner dari aliran, pilih protokol yang menentukan batas antara teks dan data biner dengan cermat, seperti membaca byte secara manual dan mendekode data.

Catatan

SerialPort Karena data buffer kelas, dan aliran yang terkandung dalam BaseStream properti tidak, keduanya mungkin bertentangan tentang berapa banyak byte yang tersedia untuk dibaca. Properti BytesToRead dapat menunjukkan bahwa ada byte untuk dibaca, tetapi byte ini mungkin tidak dapat diakses oleh aliran yang terkandung dalam BaseStream properti karena telah di-buffer ke SerialPort kelas .