NetworkStream.ReadTimeout Свойство

Определение

Возвращает или задает время, в течение которого операция чтения блокирует ожидание данных.Gets or sets the amount of time that a read operation blocks waiting for data.

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

Значение свойства

Int32

Объект Int32, указывающий период времени (в миллисекундах), по истечении которого происходит сбой операции чтения.A Int32 that specifies the amount of time, in milliseconds, that will elapse before a read operation fails. По умолчанию установлен флаг Infinite, указывающий, что время операции чтения не ограничено.The default value, Infinite, specifies that the read operation does not time out.

Исключения

Указанное значение меньше или равно нулю, и флаг Infinite не установлен.The value specified is less than or equal to zero and is not Infinite.

Примеры

В следующем примере кода время ожидания чтения для сетевого потока устанавливается равным 10 миллисекундам.The following code example sets the read time-out for a network stream to 10 milliseconds.

// 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();

Комментарии

Если операция чтения не завершается в течение времени, заданного этим свойством, операция чтения создает исключение IOException.If the read operation does not complete within the time specified by this property, the read operation throws an IOException.

Примечание

Это свойство влияет только на синхронные операции чтения, выполняемые путем вызова метода Read.This property affects only synchronous reads performed by calling the Read method. Это свойство не влияет на асинхронное чтение, выполняемое путем вызова метода BeginRead.This property does not affect asynchronous reads performed by calling the BeginRead method.

Применяется к