ASCU_ALL/DataClient/DataClientSrc.xml
2021-06-04 16:57:32 +05:00

240 lines
12 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8" ?>
<docs>
<NET>
<m n="Close">
<summary>Закрыть подключение.</summary>
</m>
<m n="Code">
<summary>Коды для работы с СТП.</summary>
</m>
<m n="Connect">
<summary>Открытие соединения к серверу.</summary>
<remarks>Информирует только о подключении к серверу. Исключения опускает.</remarks>
<returns>Состояние подключения.</returns>
</m>
<m n="Connected">
<summary>Проверка подключения.</summary>
<returns>Состояние подключения.</returns>
</m>
<m n="CreateCode">
<summary>Формирование массива байт на отправку.</summary>
<param name="code">Код комманды. Конвертируется в 4 байта. (0x00 0x00 0x00 0x00)</param>
<param name="val">Передаваемая строка.</param>
<param name="prefix">Байты перед передаваемой строкой.</param>
<param name="postfix">Байты после передаваемой строкой.</param>
<returns>Массив байт для отправки на СТП.</returns>
</m>
<m n="Full_Download">
<summary>Получение файла данных (байтами) с СТП.</summary>
<param name="date">Дата. Из неё формируется строка в формате YYYMMDD.</param>
<param name="vdp">Номер печи. 00 - общецеховые параметры.</param>
<param name="idx">Индекс файла. От 0 до 15.</param>
<remarks>Выполняет автоподключение, если оно не установлено. Не все ошибки описаны в документации.</remarks>
<returns>Обработанный массив байт.</returns>
<exception cref="ArgumentException">
Неверный код, для получения файла.
Неверный флаг во время получения файла.
</exception>
<exception cref="IOException">
Предыдущий запрос не закончен.
Поток недоступен для записи.
</exception>
<exception cref="InvalidOperationException">
Не получилось соединиться с сервером.
</exception>
</m>
<m n="Full_Download_NH">
<summary>Получение файла данных (байтами) с СТП.</summary>
<param name="date">Дата. Из неё формируется строка в формате YYYMMDD.</param>
<param name="vdp">Номер печи. 00 - общецеховые параметры.</param>
<param name="idx">Индекс файла. От 0 до 15.</param>
<remarks>Выполняет автоподключение, если оно не установлено. Не все ошибки описаны в документации.</remarks>
<returns>Обработанный массив байт.</returns>
<exception cref="ArgumentException">
Неверный код, для получения файла.
Неверный флаг во время получения файла.
</exception>
<exception cref="IOException">
Предыдущий запрос не закончен.
Поток недоступен для записи.
</exception>
<exception cref="InvalidOperationException">
Не получилось соединиться с сервером.
</exception>
</m>
<m n="GetFile">
<summary>Внутренняя функция получения файлов.</summary>
<param name="code">Код, который будет отправлен на сервер.</param>
<param name="date">Дата. Из неё формируется строка в формате YYYMMDD.</param>
<param name="vdp">Номер печи. 00 - общецеховые параметры.</param>
<param name="idx">Индекс файла. От 0 до 15.</param>
<returns>Массив байт, соответствующий запрашиваемому файлу.</returns>
<exception cref="ArgumentException">
Неверный код, для получения файла.
Неверный флаг во время получения файла.
</exception>
<exception cref="IOException">
Предыдущий запрос не закончен.
Поток недоступен для записи.
</exception>
<exception cref="InvalidOperationException">
Не получилось соединиться с сервером.
</exception>
</m>
<m n="Ip">
<summary>IP адрес СТП.</summary>
</m>
<m n="My_Close">
<summary>Внетренняя функция для закрытия соединения.</summary>
<param name="needClose">Флаг о необходимости закрыть соединение.</param>
</m>
<m n="My_Connect">
<summary>Внутренняя функция для создания подключения.</summary>
<returns>Возвращает флаг необходимости закрытия соединения.</returns>
<exception cref="InvalidOperationException">
Не получилось соединиться с сервером.
</exception>
</m>
<m n="NETClient1">
<summary>Основной конструктор класса NetClient. Ip-адрес - 127.0.0.1; Порт - 1070;</summary>
</m>
<m n="NETClient2">
<summary>Конструктор класса NetClient с параметрами.</summary>
<param name="ip">Ip-адрес сервера.</param>
<param name="port">Порт сервера.</param>
</m>
<m n="Port">
<summary>Порт СТП.</summary>
</m>
<m n="ReceiveBytes1">
<summary>Получение неизвестного количество байт.</summary>
<remarks>Возвращает null, если что-то пошло не так.</remarks>
<returns>Массив байт.</returns>
</m>
<m n="ReceiveBytes2">
<summary>Получение определенного количество байт.</summary>
<param name="size">Количество байт.</param>
<remarks>Возвращает null, если что-то пошло не так.</remarks>
<returns>Массив байт определенного размера. Может массив быть меньше, если в буфере не будет достаточно данных.</returns>
</m>
<m n="ReceiveBytesFixSize">
<summary>Получение определенного количество байт с сервера.</summary>
<param name="ns">Открытый сетевой поток.</param>
<param name="size">Кол-во получаемых байт.</param>
<param name="awaitInterval">Время ожидания между проверками буфера.</param>
<param name="tryCounts">Количество проверок буфера.</param>
<returns>Массив байт. Может быть меньше заданного количества.</returns>
<exception cref="ArgumentException">
Размер байт не должен равняться нулю.
</exception>
<exception cref="IOException">
Стрим недоступен для записи.
</exception>
<exception cref="TimeoutException">
Сервер сбросил соединение.
</exception>
</m>
<m n="ReceiveBytesFull">
<summary>Получение неопределенного количество байт с сервера. Количество ограничено максимальным значением типа UInt.</summary>
<param name="ns">Открытый сетевой поток.</param>
<param name="awaitInterval">Время ожидания между проверками буфера.</param>
<param name="tryCounts">Количество проверок буфера.</param>
<returns>Массив байт.</returns>
<exception cref="InvalidOperationException">
Соединение с сервером закрыто.
</exception>
<exception cref="IOException">
Стрим недоступен для Чтения.
</exception>
<exception cref="TimeoutException">
Сервер сбросил соединение.
</exception>
</m>
<m n="RetryCount">
<summary>Количество попыток переподключения.</summary>
</m>
<m n="RetryInterval">
<summary>Время в секундах между попытками переподключения.</summary>
</m>
<m n="SendBytes1">
<summary>Отправка массива байт на СТП.</summary>
<param name="ns">Открытый сетевой поток.</param>
<param name="arr">Массив байт.</param>
<returns>Результат отправки.</returns>
<exception cref="ArgumentException">
Размер байт не должен равняться нулю.
</exception>
<exception cref="IOException">
Стрим недоступен для записи.
</exception>
</m>
<m n="SendBytes2">
<summary>Отправка массива байт на СТП.</summary>
<param name="send">Массив байт для отправки.</param>
<returns>Результат отправки.</returns>
<exception cref="ArgumentException">
Размер байт не должен равняться нулю.
</exception>
<exception cref="IOException">
Поток недоступен для записи.
</exception>
</m>
<m n="Status">
<summary>
Статус процесса выполнения запроса.
Предполагается использовать только на больших
загрузках и в ассинхронных задачах
</summary>
</m>
<m n="Full_By_Name">
<summary>Получение файла данных (байтами) с СТП.</summary>
<param name="val">Название команды.</param>
<remarks>Выполняет автоподключение, если оно не установлено. Не все ошибки описаны в документации.</remarks>
<returns>Массив байт, соответствующий этой команде. Может вернуть null.</returns>
<exception cref="ArgumentException">
Неверный флаг во время получения файла.
</exception>
<exception cref="IOException">
Предыдущий запрос не закончен.
Поток недоступен для записи.
</exception>
<exception cref="InvalidOperationException">
Не получилось соединиться с сервером.
</exception>
</m>
<m n="Full_Dir_Browse">
<summary>Получение структуры файлов и папок в запрашиваемой директории.</summary>
<param name="dir">Путь, структуру которого надо отобразить.</param>
<remarks>Выполняет автоподключение, если оно не установлено. Не все ошибки описаны в документации.</remarks>
<returns>Массив строк. Полные пути к файлам и папкам. Может вернуть null.</returns>
<exception cref="ArgumentException">
Неверный флаг окончания строки.
Неверный флаг во время получения файла.
</exception>
<exception cref="IOException">
Предыдущий запрос не закончен.
Поток недоступен для записи.
</exception>
<exception cref="InvalidOperationException">
Не получилось соединиться с сервером.
</exception>
</m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
<m n=""></m>
</NET>
</docs>