SerialPort.Read Yöntem

Tanım

Ad Alanı:

System.IO.Ports

Bütünleştirilmiş Kod:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

Giriş arabelleğinden SerialPort okur.

Aşırı Yüklemeler

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şin yaz olduğu 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. Veya offsetcount sıfırdan küçük.

ArgumentException

offset artı count , 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, metin ve ikili veriler arasındaki sınırı el ile okuma ve verilerin kodunu çözme gibi dikkatle tanımlayan bir protokol seçin.

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

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

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şin yaz olduğu 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 ise şeklindedir null.

ArgumentOutOfRangeException

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

InvalidOperationException

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

TimeoutException

Okunabilecek karakter yok.

Açıklamalar

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

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

SerialPort Sınıfı verileri arabelleğe aldığı ve özelliğinde BaseStream yer alan akışta bulunmadığı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ğinde BaseStream bulunan akış için SerialPort erişilebilir olmayabilir.

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