SerialPort.ReadExisting Método

Definição

Namespace:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Assembly:

System.dll

Lê todos os bytes imediatamente disponíveis, baseado na codificação, no fluxo e no buffer de entrada do objeto SerialPort.

public:
 System::String ^ ReadExisting();

public string ReadExisting ();

member this.ReadExisting : unit -> string

Public Function ReadExisting () As String

Retornos

String

O conteúdo do fluxo e o buffer de entrada do objeto SerialPort.

Exceções

InvalidOperationException

A porta especificada não está aberta.

Comentários

Esse método retorna o conteúdo do fluxo e do buffer interno do SerialPort objeto como uma cadeia de caracteres. Esse método não usa um tempo limite. Observe que esse método pode deixar bytes de lead à direita no buffer interno, o que torna o BytesToRead valor maior que zero.

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

Observação

A SerialPort classe armazena dados em buffer, mas o objeto de fluxo contido na SerialPort.BaseStream propriedade não. Portanto, o SerialPort objeto e o objeto de fluxo podem diferir no número de bytes que estão disponíveis para leitura. Quando os bytes são armazenados em buffer no SerialPort objeto, a BytesToRead propriedade inclui esses bytes em seu valor; no entanto, esses bytes podem não estar acessíveis para o fluxo contido na BaseStream propriedade.