SerialPort.ReadTo(String) Método

Definição

Namespace:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Pacote:

System.IO.Ports v8.0.0

Origem:

SerialPort.cs

Lê uma cadeia de caracteres até o value especificado no buffer de entrada.

public:
 System::String ^ ReadTo(System::String ^ value);

public string ReadTo (string value);

member this.ReadTo : string -> string

Public Function ReadTo (value As String) As String

Parâmetros

value

String

Um valor que indica onde a operação de leitura deve parar.

Retornos

String

O conteúdo do buffer de entrada até o value especificado.

Exceções

ArgumentException

O tamanho do parâmetro value é 0.

ArgumentNullException

O parâmetro value é null.

InvalidOperationException

A porta especificada não está aberta.

TimeoutException

A operação não foi concluída antes do encerramento do tempo limite.

Comentários

Esse método lê uma cadeia de caracteres até o especificado value. Embora a cadeia de caracteres retornada não inclua o value, o value é removido do buffer de entrada.

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

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