SerialPort.Write Metode

Definisi

Ruang nama:

System.IO.Ports

Rakitan:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

Menulis data ke buffer output port serial.

Overload

Write(String)	Menulis string yang ditentukan ke port serial.
Write(Byte[], Int32, Int32)	Menulis jumlah byte tertentu ke port serial menggunakan data dari buffer.
Write(Char[], Int32, Int32)	Menulis sejumlah karakter tertentu ke port serial menggunakan data dari buffer.

Write(String)

Sumber:

SerialPort.cs

Menulis string yang ditentukan ke port serial.

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

public void Write (string text);

member this.Write : string -> unit

Public Sub Write (text As String)

Parameter

text

String

String untuk output.

Pengecualian

InvalidOperationException

Port yang ditentukan tidak terbuka.

ArgumentNullException

textadalah null.

TimeoutException

Operasi tidak selesai sebelum periode waktu habis berakhir.

Keterangan

Gunakan metode ini saat Anda ingin menulis string sebagai output ke port serial.

Jika ada terlalu banyak byte dalam buffer output dan Handshake diatur ke XOnXOff maka SerialPort objek dapat menaikkan beberapa TimeoutException saat menunggu perangkat siap untuk menerima lebih banyak data.

Secara default, SerialPort menggunakan ASCIIEncoding untuk mengodekan karakter. ASCIIEncoding mengodekan semua karakter yang lebih besar dari 127 sebagai (char)63 atau '?'. Untuk mendukung karakter tambahan dalam rentang tersebut, atur Encoding ke UTF8Encoding, UTF32Encoding, atau UnicodeEncoding.

Write(Byte[], Int32, Int32)

Sumber:

SerialPort.cs

Menulis jumlah byte tertentu ke port serial menggunakan data dari buffer.

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)

Parameter

buffer

Byte[]

Array byte yang berisi data untuk ditulis ke port.

offset

Int32

Offset byte berbasis nol dalam buffer parameter untuk mulai menyalin byte ke port.

count

Int32

Jumlah byte yang akan ditulis.

Pengecualian

ArgumentNullException

Yang buffer 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

Operasi tidak selesai sebelum periode waktu habis berakhir.

Keterangan

Gunakan metode ini saat Anda ingin menulis ke buffer byte untuk membuat output ke port serial.

Jika ada terlalu banyak byte dalam buffer output dan Handshake diatur ke XOnXOff maka SerialPort objek dapat menaikkan beberapa TimeoutException saat menunggu perangkat siap untuk menerima lebih banyak data.

Write(Char[], Int32, Int32)

Sumber:

SerialPort.cs

Menulis sejumlah karakter tertentu ke port serial menggunakan data dari buffer.

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)

Parameter

buffer

Char[]

Array karakter yang berisi data untuk ditulis ke port.

offset

Int32

Offset byte berbasis nol dalam buffer parameter untuk mulai menyalin byte ke port.

count

Int32

Jumlah karakter yang akan ditulis.

Pengecualian

ArgumentNullException

Yang buffer 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

Operasi tidak selesai sebelum periode waktu habis berakhir.

Keterangan

Gunakan metode ini saat Anda ingin menulis ke buffer karakter untuk membuat output ke port serial.

Jika ada terlalu banyak byte dalam buffer output dan Handshake diatur ke XOnXOff maka SerialPort objek dapat menaikkan beberapa TimeoutException saat menunggu perangkat siap untuk menerima lebih banyak data.

Secara default, SerialPort menggunakan ASCIIEncoding untuk mengodekan karakter. ASCIIEncoding mengodekan semua karakter yang lebih besar dari 127 sebagai (char)63 atau '?'. Untuk mendukung karakter tambahan dalam rentang tersebut, atur Encoding ke UTF8Encoding, UTF32Encoding, atau UnicodeEncoding.