SerialPort.ReadChar 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 karakter dari SerialPort buffer input.

public:
 int ReadChar();

public int ReadChar ();

member this.ReadChar : unit -> int

Public Function ReadChar () As Integer

Mengembalikan

Int32

Karakter yang dibaca.

Pengecualian

InvalidOperationException

Port yang ditentukan tidak terbuka.

TimeoutException

Operasi tidak selesai sebelum periode waktu habis berakhir.

-atau-

Tidak ada karakter yang tersedia dalam periode waktu habis yang dialokasikan.

Keterangan

Metode ini membaca satu karakter lengkap berdasarkan pengodean.

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 .