SerialPort.Write 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

Seri bağlantı noktası çıkış arabelleğine veri yazar.

Aşırı Yüklemeler

Write(String)	Belirtilen dizeyi seri bağlantı noktasına yazar.
Write(Byte[], Int32, Int32)	Bir arabellekten alınan verileri kullanarak seri bağlantı noktasına belirtilen sayıda bayt yazar.
Write(Char[], Int32, Int32)	Bir arabellekten alınan verileri kullanarak seri bağlantı noktasına belirtilen sayıda karakter yazar.

Write(String)

Kaynak:

SerialPort.cs

Belirtilen dizeyi seri bağlantı noktasına yazar.

public:
 void Write(System::String ^ text);

public void Write (string text);

member this.Write : string -> unit

Public Sub Write (text As String)

Parametreler

text

String

Çıkış dizesi.

Özel durumlar

InvalidOperationException

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

ArgumentNullException

text, null değeridir.

TimeoutException

Zaman aşımı süresi sona ermeden önce işlem tamamlanmadı.

Açıklamalar

Seri bağlantı noktasına çıkış olarak bir dize yazmak istediğinizde bu yöntemi kullanın.

Çıkış arabelleğinde çok fazla bayt varsa ve Handshake olarak ayarlandıysa XOnXOffSerialPort nesne, cihazın daha fazla veri kabul etmeye hazır olmasını beklerken biraz TimeoutException zaman alabilir.

Varsayılan olarak, SerialPort karakterleri kodlamak için kullanır ASCIIEncoding . ASCIIEncoding 127'den büyük tüm karakterleri (char)63 veya '?' olarak kodlar. Bu aralıktaki ek karakterleri desteklemek için , UTF32Encodingveya UnicodeEncodingolarak UTF8EncodingayarlayınEncoding.

Write(Byte[], Int32, Int32)

Kaynak:

SerialPort.cs

Bir arabellekten alınan verileri kullanarak seri bağlantı noktasına belirtilen sayıda bayt yazar.

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

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

member this.Write : byte[] * int * int -> unit

Public Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parametreler

buffer

Byte[]

Bağlantı noktasına yazacak verileri içeren bayt dizisi.

offset

Int32

Bağlantı noktasına bayt kopyalamaya buffer başlamak için parametresindeki sıfır tabanlı bayt uzaklığı.

count

Int32

Yazılacak bayt sayısı.

Özel durumlar

ArgumentNullException

geçirilen buffer değeridir 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üçüktür.

ArgumentException

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

TimeoutException

Zaman aşımı süresi sona ermeden önce işlem tamamlanmadı.

Açıklamalar

Seri bağlantı noktasına çıkış oluşturmak için bayt arabelleğine yazmak istediğinizde bu yöntemi kullanın.

Çıkış arabelleğinde çok fazla bayt varsa ve Handshake olarak ayarlandıysa XOnXOffSerialPort nesne, cihazın daha fazla veri kabul etmeye hazır olmasını beklerken biraz TimeoutException zaman alabilir.

Write(Char[], Int32, Int32)

Kaynak:

SerialPort.cs

Bir arabellekten alınan verileri kullanarak seri bağlantı noktasına belirtilen sayıda karakter yazar.

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

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

member this.Write : char[] * int * int -> unit

Public Sub Write (buffer As Char(), offset As Integer, count As Integer)

Parametreler

buffer

Char[]

Bağlantı noktasına yazacak verileri içeren karakter dizisi.

offset

Int32

Bağlantı noktasına bayt kopyalamaya buffer başlamak için parametresindeki sıfır tabanlı bayt uzaklığı.

count

Int32

Yazılacak karakter sayısı.

Özel durumlar

ArgumentNullException

geçirilen buffer değeridir 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üçüktür.

ArgumentException

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

TimeoutException

Zaman aşımı süresi sona ermeden önce işlem tamamlanmadı.

Açıklamalar

Seri bağlantı noktasına çıkış oluşturmak için karakter arabelleğine yazmak istediğinizde bu yöntemi kullanın.

Çıkış arabelleğinde çok fazla bayt varsa ve Handshake olarak ayarlandıysa XOnXOffSerialPort nesne, cihazın daha fazla veri kabul etmeye hazır olmasını beklerken biraz TimeoutException zaman alabilir.

Varsayılan olarak, SerialPort karakterleri kodlamak için kullanır ASCIIEncoding . ASCIIEncoding 127'den büyük tüm karakterleri (char)63 veya '?' olarak kodlar. Bu aralıktaki ek karakterleri desteklemek için , UTF32Encodingveya UnicodeEncodingolarak UTF8EncodingayarlayınEncoding.