SerialPort.Write Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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.
