SerialPort.Read 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.
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.