SerialPort.Write Método

Definição

Namespace:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Pacote:

System.IO.Ports v8.0.0

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

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

InvalidOperationException

A porta especificada não está aberta.

ArgumentNullException

text é null.

TimeoutException

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.

Write(Byte[], Int32, Int32)

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

ArgumentNullException

O buffer passado é null.

InvalidOperationException

A porta especificada não está aberta.

ArgumentOutOfRangeException

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.

ArgumentException

A soma de offset e count é maior que o tamanho do buffer.

TimeoutException

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.

Write(Char[], Int32, Int32)

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

ArgumentNullException

O buffer passado é null.

InvalidOperationException

A porta especificada não está aberta.

ArgumentOutOfRangeException

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.

ArgumentException

A soma de offset e count é maior que o tamanho do buffer.

TimeoutException

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.