SerialPort.Write Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Grava os dados no buffer de saída da porta serial.
Sobrecargas
| Name | Description |
|---|---|
| Write(String) |
Escreve a cadeia especificada na porta serial. |
| Write(Byte[], Int32, Int32) |
Escreve um número especificado de bytes na porta serial usando dados de um buffer. |
| Write(Char[], Int32, Int32) |
Escreve um número especificado de caracteres na porta serial usando dados de um buffer. |
Write(String)
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
Escreve a cadeia especificada na porta serial.
public:
void Write(System::String ^ text);public void Write(string text);member this.Write : string -> unitPublic Sub Write (text As String)Parâmetros
- text
- String
A cadeia para saída.
Exceções
A porta especificada não está aberta.
text é null.
A operação não foi concluída antes do término do período de pausa.
Observações
Use este método quando quiser escrever uma string como saída para uma porta serial.
Se houver demasiados bytes no buffer de saída e Handshake estiver definido para XOnXOff , o SerialPort objeto pode aumentar enquanto TimeoutException espera que o dispositivo esteja pronto para aceitar mais dados.
Por defeito, SerialPort serve ASCIIEncoding para codificar os caracteres. ASCIIEncoding codifica todos os caracteres superiores a 127 como (char)63 ou '?'. Para suportar personagens adicionais nesse intervalo, defina Encoding para UTF8Encoding, UTF32Encoding, ou UnicodeEncoding.
Aplica-se a
Write(Byte[], Int32, Int32)
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
Escreve um número especificado de bytes na porta serial usando dados de um 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)Parâmetros
- buffer
- Byte[]
O array de bytes que contém os dados a escrever na porta.
- offset
- Int32
O deslocamento de bytes baseado em zero no buffer parâmetro a partir do qual começar a copiar bytes para a porta.
- count
- Int32
O número de bytes a escrever.
Exceções
O buffer passado é null.
A porta especificada não está aberta.
Os offset parâmetros ou count estão fora de uma região válida do buffer que está a ser passado. Ou offsetcount é menor que zero.
offset mais count é maior do que o comprimento do buffer.
A operação não foi concluída antes do término do período de pausa.
Observações
Use este método quando quiser escrever num buffer de bytes para criar saída numa porta serial.
Se houver demasiados bytes no buffer de saída e Handshake estiver definido para XOnXOff , o SerialPort objeto pode aumentar enquanto TimeoutException espera que o dispositivo esteja pronto para aceitar mais dados.
Aplica-se a
Write(Char[], Int32, Int32)
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
Escreve um número especificado de caracteres na porta serial usando dados de um 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)Parâmetros
- buffer
- Char[]
O array de caracteres que contém os dados a escrever na porta.
- offset
- Int32
O deslocamento de bytes baseado em zero no buffer parâmetro a partir do qual começar a copiar bytes para a porta.
- count
- Int32
O número de caracteres a escrever.
Exceções
O buffer passado é null.
A porta especificada não está aberta.
Os offset parâmetros ou count estão fora de uma região válida do buffer que está a ser passado. Ou offsetcount é menor que zero.
offset mais count é maior do que o comprimento do buffer.
A operação não foi concluída antes do término do período de pausa.
Observações
Use este método quando quiser escrever num buffer de caracteres para criar saída para uma porta serial.
Se houver demasiados bytes no buffer de saída e Handshake estiver definido para XOnXOff , o SerialPort objeto pode aumentar enquanto TimeoutException espera que o dispositivo esteja pronto para aceitar mais dados.
Por defeito, SerialPort serve ASCIIEncoding para codificar os caracteres. ASCIIEncoding codifica todos os caracteres superiores a 127 como (char)63 ou '?'. Para suportar personagens adicionais nesse intervalo, defina Encoding para UTF8Encoding, UTF32Encoding, ou UnicodeEncoding.
