SerialPort.Read Metode

Definisi

Ruang nama:

System.IO.Ports

Rakitan:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

Membaca dari SerialPort buffer input.

Overload

Read(Byte[], Int32, Int32)	Membaca sejumlah byte dari SerialPort buffer input dan menulis byte tersebut ke dalam array byte pada offset yang ditentukan.
Read(Char[], Int32, Int32)	Membaca sejumlah karakter dari SerialPort buffer input dan menulisnya ke dalam array karakter pada offset tertentu.

Read(Byte[], Int32, Int32)

Sumber:

SerialPort.cs

Membaca sejumlah byte dari SerialPort buffer input dan menulis byte tersebut ke dalam array byte pada offset yang ditentukan.

public:
 int Read(cli::array <System::Byte> ^ buffer, int offset, int count);

public int Read (byte[] buffer, int offset, int count);

member this.Read : byte[] * int * int -> int

Public Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer

Parameter

buffer

Byte[]

Array byte untuk menulis input.

offset

Int32

Offset untuk buffer menulis byte.

count

Int32

Jumlah maksimum byte yang akan dibaca. Lebih sedikit byte yang dibaca jika count lebih besar dari jumlah byte dalam buffer input.

Mengembalikan

Int32

Jumlah byte yang dibaca.

Pengecualian

ArgumentNullException

Buffer yang diteruskan adalah null.

InvalidOperationException

Port yang ditentukan tidak terbuka.

ArgumentOutOfRangeException

Parameter offset atau count berada di luar wilayah yang valid dari yang buffer diteruskan. Baik offset atau count kurang dari nol.

ArgumentException

offset plus count lebih besar dari panjang buffer.

TimeoutException

Tidak ada byte yang tersedia untuk dibaca.

Keterangan

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.

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 .

Metode Read ini tidak memblokir operasi lain ketika jumlah byte yang dibaca sama count tetapi masih ada byte yang belum dibaca yang tersedia pada port serial.

Read(Char[], Int32, Int32)

Sumber:

SerialPort.cs

Membaca sejumlah karakter dari SerialPort buffer input dan menulisnya ke dalam array karakter pada offset tertentu.

public:
 int Read(cli::array <char> ^ buffer, int offset, int count);

public int Read (char[] buffer, int offset, int count);

member this.Read : char[] * int * int -> int

Public Function Read (buffer As Char(), offset As Integer, count As Integer) As Integer

Parameter

buffer

Char[]

Array karakter untuk menulis input.

offset

Int32

Offset untuk buffer menulis karakter.

count

Int32

Jumlah maksimum karakter yang akan dibaca. Lebih sedikit karakter yang dibaca jika count lebih besar dari jumlah karakter dalam buffer input.

Mengembalikan

Int32

Jumlah karakter yang dibaca.

Pengecualian

ArgumentException

offset plus count lebih besar dari panjang buffer.

-atau-

count adalah 1 dan ada karakter pengganti di buffer.

ArgumentNullException

Yang buffer diteruskan adalah null.

ArgumentOutOfRangeException

Parameter offset atau count berada di luar wilayah yang valid dari yang buffer diteruskan. Baik offset atau count kurang dari nol.

InvalidOperationException

Port yang ditentukan tidak terbuka.

TimeoutException

Tidak ada karakter yang tersedia untuk dibaca.

Keterangan

Gunakan metode ini untuk membaca karakter dari port serial.

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.

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

Metode Read ini tidak memblokir operasi lain ketika jumlah byte yang dibaca sama count tetapi masih ada byte yang belum dibaca yang tersedia pada port serial.