IFileConverterComposerBeginConversionAsync - метод

Запускает процесс конвертации файла карточки в заданный формат и возвращает идентификатор операции, по которой можно контролировать ход конвертации. Вторым полем возвращает новое значение параметра requestHash. Файл после конвертации обычно помещается в кэш, но этот метод всегда создаёт новую операцию по конвертации, даже если конвертация этой версии файла уже была выполнена и содержится в кэше.

Definition

Пространство имён: Tessa.FileConverters
Сборка: Tessa (в Tessa.dll) Версия: 4.0.4
C#
Task<(Guid operationID, byte[] )> BeginConversionAsync(
	IFileConverterRequest request,
	byte[] requestHash,
	bool failWhenHasSameRequestHash = true,
	CancellationToken cancellationToken = default
)

Параметры

request  IFileConverterRequest
Запрос на выполнение операции.
requestHash  Byte
Вычисленный хеш от запроса или null, если хеш будет вычислен в процессе выполнения метода. При первом вызове метода для одного и того же запроса рекомендуется передавать null, а при последующих вызовах - результат предыдущего вызова.
failWhenHasSameRequestHash  Boolean  (Optional)
Создание операции запрещено и вызовет [Tessa.Platform.Operations.OperationAlreadyExistsException], если в настоящий момент выполняется операция с таким же хешом requestHash. Укажите значение false, если возможно параллельное выполнение операций для одного и того же файла с теми же параметрами конвертации. Укажите значение true указывается, чтобы одинаковые операции по конвертации выполнялись параллельно, а повторная операция по конвертации не создавалась, вместо этого организуется ожидание по окончанию существующей операции.
cancellationToken  CancellationToken  (Optional)
Объект, посредством которого можно отменить асинхронную задачу.

Возвращаемое значение

TaskValueTupleGuid, Byte
Идентификатор операции, по которой можно контролировать ход конвертации.

См. также