Partilhar via


SerialPort.Write Método

Definição

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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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.

Aplica-se a