FileConverterComposer.BeginConversionAsync - метод

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

Definition

Пространство имён: Tessa.FileConverters
Сборка: Tessa (в Tessa.dll) Версия: 4.0.5
C#
public 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)
Объект, посредством которого можно отменить асинхронную задачу.

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

Task<ValueTuple<Guid, Byte[]>>
Идентификатор операции, по которой можно контролировать ход конвертации.

Реализации

IFileConverterComposer.BeginConversionAsync(IFileConverterRequest, Byte[], Boolean, CancellationToken)

См. также