SerialPort.Read Yöntem

Tanım

Ad Alanı:

System.IO.Ports

Bütünleştirilmiş Kod:

System.IO.Ports.dll

Paket:

System.IO.Ports v11.0.0-preview.2.26159.112

Giriş arabelleğinden SerialPort okur.

Aşırı Yüklemeler

Name	Description
Read(Byte[], Int32, Int32)	Giriş arabelleğinden SerialPort bir dizi bayt okur ve bu baytları belirtilen uzaklıkta bir bayt dizisine yazar.
Read(Char[], Int32, Int32)	Giriş arabelleğinden SerialPort bir dizi karakteri okur ve bunları belirli bir uzaklıkta bir karakter dizisine yazar.

Read(Byte[], Int32, Int32)

Kaynak:

SerialPort.cs

Giriş arabelleğinden SerialPort bir dizi bayt okur ve bu baytları belirtilen uzaklıkta bir bayt dizisine yazar.

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

Parametreler

buffer

Byte[]

Girişi yazacak bayt dizisi.

offset

Int32

Baytların yazıldığı uzaklık buffer .

count

Int32

Okunacak bayt sayısı üst sınırı. Giriş arabelleğindeki bayt sayısından büyükse count daha az bayt okunur.

Döndürülenler

Int32

Okunan bayt sayısı.

Özel durumlar

ArgumentNullException

Geçirilen arabellek şeklindedir null.

InvalidOperationException

Belirtilen bağlantı noktası açık değil.

ArgumentOutOfRangeException

offset veya count parametreleri geçirilmekte olan geçerli bir bölgenin buffer dışında. Ya da offsetcount sıfırdan küçüktür.

ArgumentException

offset artı count , değerinin uzunluğundan bufferbüyüktür.

TimeoutException

Okunabilecek bayt yok.

Açıklamalar

Metin okuma ile akıştan ikili verileri okuma arasında geçiş yapmak gerekiyorsa, el ile bayt okuma ve verilerin kodunu çözme gibi metin ve ikili veriler arasındaki sınırı dikkatle tanımlayan bir protokol seçin.

SerialPort Sınıfı verileri arabelleğe alır ve özelliğinde BaseStream yer alan akış arabelleğe almadığından, bu ikisi okunabilecek bayt sayısıyla ilgili çakışabilir. BytesToRead özelliği, okunacak baytlar olduğunu gösterebilir, ancak bu baytlar sınıfına arabelleğe alındıkları için özelliğin BaseStream içerdiği akış için SerialPort erişilebilir olmayabilir.

yöntemi, Read okunan bayt sayısı eşit count olduğunda diğer işlemleri engellemez, ancak seri bağlantı noktasında hala okunmamış baytlar vardır.

Read(Char[], Int32, Int32)

Kaynak:

SerialPort.cs

Giriş arabelleğinden SerialPort bir dizi karakteri okur ve bunları belirli bir uzaklıkta bir karakter dizisine yazar.

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

Parametreler

buffer

Char[]

Girişi yazacak karakter dizisi.

offset

Int32

Karakterlerin yazıldığı uzaklık buffer .

count

Int32

Okunacak karakter sayısı üst sınırı. Giriş arabelleğindeki karakter sayısından büyükse count daha az karakter okunur.

Döndürülenler

Int32

Okunan karakter sayısı.

Özel durumlar

ArgumentException

offset artı count , arabelleğin uzunluğundan büyüktür.

-veya-

count 1'dir ve arabellekte bir vekil karakter vardır.

ArgumentNullException

Geçirilen buffer değeridir null.

ArgumentOutOfRangeException

offset veya count parametreleri geçirilmekte olan geçerli bir bölgenin buffer dışında. Ya da offsetcount sıfırdan küçüktür.

InvalidOperationException

Belirtilen bağlantı noktası açık değil.

TimeoutException

Okunabilecek karakter yok.

Açıklamalar

Seri bağlantı noktasındaki karakterleri okumak için bu yöntemi kullanın.

Metin okuma ile akıştan ikili verileri okuma arasında geçiş yapmak gerekiyorsa, el ile bayt okuma ve verilerin kodunu çözme gibi metin ve ikili veriler arasındaki sınırı dikkatle tanımlayan bir protokol seçin.

SerialPort Sınıfı verileri arabelleğe alır ve özelliğinde BaseStream yer alan akış arabelleğe almadığından, bu ikisi kaç karakterin okunabileceği konusunda çakışabilir. BytesToRead özelliği, okunacak karakterler olduğunu gösterebilir, ancak bu karakterler sınıfına arabelleğe alındıkları için özelliğin BaseStream içerdiği akış için SerialPort erişilebilir olmayabilir.

yöntemi, Read okunan bayt sayısı eşit count olduğunda diğer işlemleri engellemez, ancak seri bağlantı noktasında hala okunmamış baytlar vardır.