Condividi tramite


SerialPort.Write Metodo

Definizione

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
Origine:
SerialPort.cs
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

La porta specificata non è aperta.

text è null.

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.

Si applica a

Write(Byte[], Int32, Int32)

Origine:
SerialPort.cs
Origine:
SerialPort.cs
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

Il valore di buffer passato è null.

La porta specificata non è aperta.

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

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

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.

Si applica a

Write(Char[], Int32, Int32)

Origine:
SerialPort.cs
Origine:
SerialPort.cs
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

Il valore di buffer passato è null.

La porta specificata non è aperta.

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

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

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.

Si applica a