SerialPort.ReadTo(String) Metode

Definisi

Ruang nama:

System.IO.Ports

Rakitan:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

Sumber:

SerialPort.cs

Membaca string hingga yang ditentukan value dalam buffer input.

public:
 System::String ^ ReadTo(System::String ^ value);

public string ReadTo (string value);

member this.ReadTo : string -> string

Public Function ReadTo (value As String) As String

Parameter

value

String

Nilai yang menunjukkan di mana operasi baca berhenti.

Mengembalikan

String

Konten buffer input hingga yang ditentukan value.

Pengecualian

ArgumentException

Panjang value parameter adalah 0.

ArgumentNullException

Parameternya value adalah null.

InvalidOperationException

Port yang ditentukan tidak terbuka.

TimeoutException

Operasi tidak selesai sebelum periode waktu habis berakhir.

Keterangan

Metode ini membaca string hingga yang ditentukan value. Meskipun string yang dikembalikan tidak menyertakan value, value dihapus dari buffer input.

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 .