SerialPort.Write Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Grava dados no buffer de saída da porta serial.
Sobrecargas
| Write(String) |
Grava a cadeia de caracteres especificada para a porta serial. |
| Write(Byte[], Int32, Int32) |
Grava um número especificado de bytes na porta serial usando dados de um buffer. |
| Write(Char[], Int32, Int32) |
Grava 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
Grava a cadeia de caracteres especificada para a 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 de caracteres de saída.
Exceções
A porta especificada não está aberta.
text é null.
A operação não foi concluída antes do encerramento do tempo limite.
Comentários
Use esse método quando quiser gravar uma cadeia de caracteres como saída em uma porta serial.
Se houver muitos bytes no buffer de saída e Handshake estiver definido como XOnXOff , o SerialPort objeto poderá gerar um TimeoutException tempo enquanto aguarda o dispositivo estar pronto para aceitar mais dados.
Por padrão, SerialPort usa para codificar os caracteres ASCIIEncoding . ASCIIEncoding codifica todos os caracteres maiores que 127 como (char)63 ou '?'. Para dar suporte a caracteres adicionais nesse intervalo, defina Encoding como UTF8Encoding, UTF32Encodingou UnicodeEncoding.
Aplica-se a
Write(Byte[], Int32, Int32)
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
Grava 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[]
A matriz de bytes que contém os dados a serem gravados na porta.
- offset
- Int32
O deslocamento de bytes baseado em zero no parâmetro buffer no qual começar a copiar bytes para a porta.
- count
- Int32
O número de bytes a serem gravados.
Exceções
O buffer passado é null.
A porta especificada não está aberta.
Os parâmetros offset ou count estão fora de uma região válida do buffer que está sendo passado. offset ou count é menor que zero.
A soma de offset e count é maior que o tamanho do buffer.
A operação não foi concluída antes do encerramento do tempo limite.
Comentários
Use esse método quando quiser gravar em um buffer de bytes para criar uma saída em uma porta serial.
Se houver muitos bytes no buffer de saída e Handshake estiver definido como XOnXOff , o SerialPort objeto poderá gerar um TimeoutException tempo enquanto aguarda o dispositivo estar pronto para aceitar mais dados.
Aplica-se a
Write(Char[], Int32, Int32)
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
- Origem:
- SerialPort.cs
Grava 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[]
A matriz de caracteres que contém os dados a serem gravados na porta.
- offset
- Int32
O deslocamento de bytes baseado em zero no parâmetro buffer no qual começar a copiar bytes para a porta.
- count
- Int32
O número de caracteres a serem gravados.
Exceções
O buffer passado é null.
A porta especificada não está aberta.
Os parâmetros offset ou count estão fora de uma região válida do buffer que está sendo passado. offset ou count é menor que zero.
A soma de offset e count é maior que o tamanho do buffer.
A operação não foi concluída antes do encerramento do tempo limite.
Comentários
Use esse método quando quiser gravar em um buffer de caracteres para criar uma saída para uma porta serial.
Se houver muitos bytes no buffer de saída e Handshake estiver definido como XOnXOff , o SerialPort objeto poderá gerar um TimeoutException tempo enquanto aguarda o dispositivo estar pronto para aceitar mais dados.
Por padrão, SerialPort usa para codificar os caracteres ASCIIEncoding . ASCIIEncoding codifica todos os caracteres maiores que 127 como (char)63 ou '?'. Para dar suporte a caracteres adicionais nesse intervalo, defina Encoding como UTF8Encoding, UTF32Encodingou UnicodeEncoding.
