SerialDevice.ReadTimeout Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение времени ожидания для операции чтения.
public:
property TimeSpan ReadTimeout { TimeSpan get(); void set(TimeSpan value); };
TimeSpan ReadTimeout();
void ReadTimeout(TimeSpan value);
public System.TimeSpan ReadTimeout { get; set; }
var timeSpan = serialDevice.readTimeout;
serialDevice.readTimeout = timeSpan;
Public Property ReadTimeout As TimeSpan
Значение свойства
Интервал времени до истечения времени ожидания, когда операция чтения не завершается.
- Если readTimeout равно 0, максимальный интервал между последовательными байтами в операциях чтения отсутствует. Это значит, что время ожидания операций чтения никогда не истекает.
- Если параметр ReadTimeout имеет значение
TimeSpan.FromMilliseconds(ulong.MaxValue)
(см. раздел TimeSpan), запрос на чтение немедленно завершается с уже полученными байтами, даже если байты не были получены. - Если readTimeout меньше
TimeSpan.FromMilliseconds(ulong.MaxValue)
, а больше 0, время ожидания операции чтения истекает, только если интервал между парой последовательно полученных байтов превышает ReadTimeout.
Примечание
API среда выполнения Windows для последовательных устройств тонко упаковывают функциональные возможности соответствующих API Win32. Таким образом, значение элемента ReadIntervalTimeout структуры SERIAL_TIMEOUTS Win32 применяется к SerialDevice.ReadTimeout. Особенности см. в разделах Структура SERIAL_TIMEOUTS и Настройка времени ожидания чтения и записи для серийного устройства.