SerialPort.Write Metodo

Definizione

Spazio dei nomi:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Pacchetto:

System.IO.Ports v8.0.0

Scrive i dati nel buffer di output della porta seriale.

Overload

Write(String)	Scrive sulla porta seriale la stringa specificata.
Write(Byte[], Int32, Int32)	Scrive sulla porta un numero specificato di byte sulla porta seriale usando i dati di un buffer.
Write(Char[], Int32, Int32)	Scrive sulla porta seriale un numero specificato di caratteri usando i dati di un buffer.

Write(String)

Origine:

SerialPort.cs

Scrive sulla porta seriale la stringa specificata.

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

public void Write (string text);

member this.Write : string -> unit

Public Sub Write (text As String)

Parametri

text

String

Stringa per l'output.

Eccezioni

InvalidOperationException

La porta specificata non è aperta.

ArgumentNullException

text è null.

TimeoutException

L'operazione non è stata completata prima dello scadere del periodo di timeout.

Commenti

Usare questo metodo quando si vuole scrivere una stringa come output in una porta seriale.

Se nel buffer di output sono presenti troppi byte ed Handshake è impostato su XOnXOff , l'oggetto SerialPort potrebbe generare un TimeoutException po' in attesa che il dispositivo sia pronto ad accettare altri dati.

Per impostazione predefinita, SerialPort usa ASCIIEncoding per codificare i caratteri. ASCIIEncoding codifica tutti i caratteri maggiori di 127 come (char)63 o '?'. Per supportare caratteri aggiuntivi in tale intervallo, impostare Encoding su UTF8Encoding, UTF32Encodingo UnicodeEncoding.

Write(Byte[], Int32, Int32)

Origine:

SerialPort.cs

Scrive sulla porta un numero specificato di byte sulla porta seriale usando i dati di un 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)

Parametri

buffer

Byte[]

Matrice di byte che contiene i dati da scrivere sulla porta.

offset

Int32

Offset dei byte in base zero nel parametro buffer da cui iniziare la copia dei byte sulla porta.

count

Int32

Numero di byte da scrivere.

Eccezioni

ArgumentNullException

Il valore di buffer passato è null.

InvalidOperationException

La porta specificata non è aperta.

ArgumentOutOfRangeException

Il parametro offset o count si trova al di fuori dell'area di validità del parametro buffer passato. offset o count è minore di zero.

ArgumentException

offset più count è maggiore della lunghezza del parametro buffer.

TimeoutException

L'operazione non è stata completata prima dello scadere del periodo di timeout.

Commenti

Usare questo metodo quando si vuole scrivere in un buffer di byte per creare l'output in una porta seriale.

Se nel buffer di output sono presenti troppi byte ed Handshake è impostato su XOnXOff , l'oggetto SerialPort potrebbe generare un TimeoutException po' in attesa che il dispositivo sia pronto ad accettare altri dati.

Write(Char[], Int32, Int32)

Origine:

SerialPort.cs

Scrive sulla porta seriale un numero specificato di caratteri usando i dati di un 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)

Parametri

buffer

Char[]

Matrice di caratteri che contiene i dati da scrivere sulla porta.

offset

Int32

Offset dei byte in base zero nel parametro buffer da cui iniziare la copia dei byte sulla porta.

count

Int32

Numero di caratteri da scrivere.

Eccezioni

ArgumentNullException

Il valore di buffer passato è null.

InvalidOperationException

La porta specificata non è aperta.

ArgumentOutOfRangeException

Il parametro offset o count si trova al di fuori dell'area di validità del parametro buffer passato. offset o count è minore di zero.

ArgumentException

offset più count è maggiore della lunghezza del parametro buffer.

TimeoutException

L'operazione non è stata completata prima dello scadere del periodo di timeout.

Commenti

Usare questo metodo quando si vuole scrivere in un buffer di caratteri per creare l'output in una porta seriale.

Se nel buffer di output sono presenti troppi byte ed Handshake è impostato su XOnXOff , l'oggetto SerialPort potrebbe generare un TimeoutException po' in attesa che il dispositivo sia pronto ad accettare altri dati.

Per impostazione predefinita, SerialPort usa ASCIIEncoding per codificare i caratteri. ASCIIEncoding codifica tutti i caratteri maggiori di 127 come (char)63 o '?'. Per supportare caratteri aggiuntivi in tale intervallo, impostare Encoding su UTF8Encoding, UTF32Encodingo UnicodeEncoding.