SerialPort.Write Metodo

Definizione

Scrive i dati nel buffer di output della porta seriale.

Overload

Nome Descrizione
Write(String)

Scrive la stringa specificata nella porta seriale.

Write(Byte[], Int32, Int32)

Scrive un numero specificato di byte nella porta seriale usando i dati di un buffer.

Write(Char[], Int32, Int32)

Scrive un numero specificato di caratteri nella porta seriale usando i dati di un buffer.

Write(String)

Origine:
SerialPort.cs
Origine:
SerialPort.cs
Origine:
SerialPort.cs
Origine:
SerialPort.cs

Scrive la stringa specificata nella porta seriale.

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 del termine del periodo di timeout.

Commenti

Utilizzare questo metodo quando si desidera scrivere una stringa come output in una porta seriale.

Se nel buffer di output sono presenti troppi byte e Handshake viene impostato su XOnXOff , l'oggetto SerialPort potrebbe generare un TimeoutException po' di tempo prima 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 su EncodingUTF8Encoding, UTF32Encodingo UnicodeEncoding.

Si applica a

Write(Byte[], Int32, Int32)

Origine:
SerialPort.cs
Origine:
SerialPort.cs
Origine:
SerialPort.cs
Origine:
SerialPort.cs

Scrive un numero specificato di byte nella 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 nella porta.

offset
Int32

Offset dei byte in base zero nel parametro in corrispondenza del buffer quale iniziare a copiare byte nella porta.

count
Int32

Numero di byte da scrivere.

Eccezioni

L'oggetto buffer passato è null.

La porta specificata non è aperta.

I offset parametri o count si trovano all'esterno di un'area valida dell'oggetto buffer passato. offset O count è minore di zero.

offset plus count è maggiore della lunghezza dell'oggetto buffer.

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

Commenti

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

Se nel buffer di output sono presenti troppi byte e Handshake viene impostato su XOnXOff , l'oggetto SerialPort potrebbe generare un TimeoutException po' di tempo prima 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
Origine:
SerialPort.cs

Scrive un numero specificato di caratteri nella porta seriale 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 contenente i dati da scrivere nella porta.

offset
Int32

Offset dei byte in base zero nel parametro in corrispondenza del buffer quale iniziare a copiare byte nella porta.

count
Int32

Numero di caratteri da scrivere.

Eccezioni

L'oggetto buffer passato è null.

La porta specificata non è aperta.

I offset parametri o count si trovano all'esterno di un'area valida dell'oggetto buffer passato. offset O count è minore di zero.

offset plus count è maggiore della lunghezza dell'oggetto buffer.

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

Commenti

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

Se nel buffer di output sono presenti troppi byte e Handshake viene impostato su XOnXOff , l'oggetto SerialPort potrebbe generare un TimeoutException po' di tempo prima 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 su EncodingUTF8Encoding, UTF32Encodingo UnicodeEncoding.

Si applica a