Idioma

SerialPort.Read Método

Definição

Lê do SerialPort buffer de entrada.

Sobrecargas

Nome Descrição
Read(Byte[], Int32, Int32)

Lê um número de bytes do SerialPort buffer de entrada e escreve esses bytes num array de bytes no offset especificado.

Read(Char[], Int32, Int32)

Lê vários caracteres do SerialPort buffer de entrada e escreve-os num array de caracteres num determinado deslocamento.

Read(Byte[], Int32, Int32)

Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs

Lê um número de bytes do SerialPort buffer de entrada e escreve esses bytes num array de bytes no offset especificado.

public:
 int Read(cli::array <System::Byte> ^ buffer, int offset, int count);
public int Read(byte[] buffer, int offset, int count);
member this.Read : byte[] * int * int -> int
Public Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer

Parâmetros

buffer
Byte[]

O array de bytes para escrever a entrada.

offset
Int32

O deslocamento em buffer onde escrever os bytes.

count
Int32

O número máximo de bytes a ler. Menos bytes são lidos se count for maior do que o número de bytes no buffer de entrada.

Devoluções

O número de bytes lidos.

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.

Não havia bytes disponíveis para leitura.

Observações

Se for necessário alternar entre ler texto e ler dados binários do fluxo, selecione um protocolo que defina cuidadosamente a fronteira entre o texto e os dados binários, como ler manualmente bytes e decodificar os dados.

Como a SerialPort classe armazena os dados, e o fluxo contido na BaseStream propriedade não, os dois podem entrar em conflito sobre quantos bytes estão disponíveis para leitura. A BytesToRead propriedade pode indicar que existem bytes para ler, mas esses bytes podem não ser acessíveis ao fluxo contido na BaseStream propriedade porque foram armazenados na SerialPort classe.

O Read método não bloqueia outras operações quando o número de bytes lidos é count igual, mas ainda existem bytes não lidos disponíveis na porta serial.

Aplica-se a

Read(Char[], Int32, Int32)

Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs

Lê vários caracteres do SerialPort buffer de entrada e escreve-os num array de caracteres num determinado deslocamento.

public:
 int Read(cli::array <char> ^ buffer, int offset, int count);
public int Read(char[] buffer, int offset, int count);
member this.Read : char[] * int * int -> int
Public Function Read (buffer As Char(), offset As Integer, count As Integer) As Integer

Parâmetros

buffer
Char[]

O array de caracteres para escrever a entrada.

offset
Int32

O deslocamento em buffer onde escrever as personagens.

count
Int32

O número máximo de caracteres para ler. Menos caracteres são lidos se count for maior do que o número de caracteres no buffer de entrada.

Devoluções

O número de caracteres lidos.

Exceções

offset mais count é maior do que o comprimento do buffer.

-ou-

count é 1 e há uma personagem substituta no buffer.

O buffer passado é null.

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.

A porta especificada não está aberta.

Não havia caracteres disponíveis para leitura.

Observações

Use este método para ler caracteres da porta serial.

Se for necessário alternar entre ler texto e ler dados binários do fluxo, selecione um protocolo que defina cuidadosamente a fronteira entre o texto e os dados binários, como ler manualmente bytes e decodificar os dados.

Como a SerialPort classe armazena os dados, e o fluxo contido na BaseStream propriedade não, os dois podem entrar em conflito quanto ao número de caracteres disponíveis para leitura. A BytesToRead propriedade pode indicar que existem caracteres para ler, mas estes caracteres podem não ser acessíveis ao fluxo contido na BaseStream propriedade porque foram armazenados em buffer para a SerialPort classe.

O Read método não bloqueia outras operações quando o número de bytes lidos é count igual, mas ainda existem bytes não lidos disponíveis na porta serial.

Aplica-se a