SerialPort.ReadExisting Metode

Definisi

Ruang nama:

System.IO.Ports

Rakitan:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

Sumber:

SerialPort.cs

Membaca semua byte yang tersedia segera, berdasarkan pengodean, baik di aliran maupun buffer SerialPort input objek.

public:
 System::String ^ ReadExisting();

public string ReadExisting ();

member this.ReadExisting : unit -> string

Public Function ReadExisting () As String

Mengembalikan

String

Konten aliran dan buffer SerialPort input objek.

Pengecualian

InvalidOperationException

Port yang ditentukan tidak terbuka.

Keterangan

Metode ini mengembalikan konten aliran dan buffer SerialPort internal objek sebagai string. Metode ini tidak menggunakan waktu habis. Perhatikan bahwa metode ini dapat meninggalkan byte prospek di buffer internal, yang membuat BytesToRead nilai lebih besar dari nol.

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

Buffer SerialPort kelas data, tetapi objek stream yang terkandung dalam SerialPort.BaseStream properti tidak. Oleh karena itu, SerialPort objek dan objek stream mungkin berbeda pada jumlah byte yang tersedia untuk dibaca. Ketika byte di-buffer ke SerialPort objek, BytesToRead properti menyertakan byte ini dalam nilainya; namun, byte ini mungkin tidak dapat diakses oleh aliran yang terkandung dalam BaseStream properti .