NetworkStream.ReadTimeout Propriedade
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.
Obtém ou define o tempo que uma operação de leitura bloqueia à espera de dados.
public:
virtual property int ReadTimeout { int get(); void set(int value); };
public override int ReadTimeout { get; set; }
member this.ReadTimeout : int with get, set
Public Overrides Property ReadTimeout As Integer
Valor de Propriedade
A Int32 que especifica o tempo, em milissegundos, que decorrerá antes de uma operação de leitura falhar. O valor padrão, Infinite, especifica que a operação de leitura não expira.
Exceções
O valor especificado é menor ou igual a zero e não Infiniteé .
Exemplos
O exemplo de código seguinte define o time-out de leitura de um fluxo de rede para 10 milissegundos.
// Create a client that will connect to a
// server listening on the contosoServer computer
// at port 11000.
TcpClient tcpClient = new TcpClient();
tcpClient.Connect("contosoServer", 11000);
// Get the stream used to read the message sent by the server.
NetworkStream networkStream = tcpClient.GetStream();
// Set a 10 millisecond timeout for reading.
networkStream.ReadTimeout = 10;
// Read the server message into a byte buffer.
byte[] bytes = new byte[1024];
networkStream.Read(bytes, 0, 1024);
//Convert the server's message into a string and display it.
string data = Encoding.UTF8.GetString(bytes);
Console.WriteLine("Server sent message: {0}", data);
networkStream.Close();
tcpClient.Close();
Observações
Se a operação de leitura não for concluída dentro do tempo especificado por esta propriedade, a operação de leitura gera um IOException.
Note
Esta propriedade afeta apenas as leituras síncronas realizadas ao chamar o Read método. Esta propriedade não afeta as leituras assíncronas realizadas ao chamar o BeginRead método ou.ReadAsync