ICardManagerCreateFromTemplateAsync(CardStoreRequest, CardHeader, FuncInt64, CancellationToken, ValueTaskSubStream, FuncCardFileContentParameter, ValueTask, DictionaryString, Object, ICardFileSourceMapping, IValidationResultBuilder, CancellationToken) - метод

Создаёт карточку по шаблону.

Definition

Пространство имён: Tessa.Cards
Сборка: Tessa (в Tessa.dll) Версия: 4.0.4
C#
Task<(CardNewRequest Request, CardNewResponse? Response)> CreateFromTemplateAsync(
	CardStoreRequest request,
	CardHeader? header = null,
	Func<long, CancellationToken, ValueTask<SubStream>>? readNextFileFuncAsync = null,
	Func<CardFileContentParameter, ValueTask>? processFileActionAsync = null,
	Dictionary<string, Object?>? templateInfo = null,
	ICardFileSourceMapping? externalMapping = null,
	IValidationResultBuilder? extraErrorValidation = null,
	CancellationToken cancellationToken = default
)

Параметры

request  CardStoreRequest
Запрос на сохранение карточки шаблона, в котором содержится как исходная (экспортированная) карточка, из которой создаётся новая карточка, так и дополнительная информация в Info.
header  CardHeader  (Optional)
Заголовок, содержащий информацию о файлах шаблона, или null, если считается, что файлов в шаблоне нет.
readNextFileFuncAsync  FuncInt64, CancellationToken, ValueTaskSubStream  (Optional)
Функция, выполняющая чтение контента очередного файла заданного размера, или null, если считается, что файлов в шаблоне нет. Порядок файлов определяется в заголовке header.
processFileActionAsync  FuncCardFileContentParameter, ValueTask  (Optional)
Метод, выполняющий обработку для каждого из файлов, приложенных к карточке, или null, если считается, что файлов в шаблоне нет.
templateInfo  DictionaryString, Object  (Optional)

Дополнительная информация, помещаемая в запрос на создание карточки по шаблону, или null, если дополнительная информация отсутствует.

Если при экспорте карточки была задана дополнительная информация, то она совмещается с заданной в этом параметре, причём при совпадении ключей информация в параметре переопределяет информацию, заданную при экспорте.

externalMapping  ICardFileSourceMapping  (Optional)
Информация по отображению источников внешнего контента в файлах карточки. Указывает на соответствие внешнего источника для каждого найденного в объекте файла, что переопределяет загрузку контента такого файла на клиенте.
extraErrorValidation  IValidationResultBuilder  (Optional)
Дополнительная валидация ошибок или null.
cancellationToken  CancellationToken  (Optional)
Объект, посредством которого можно отменить асинхронную задачу.

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

TaskValueTupleCardNewRequest, CardNewResponse
Результат операции, т.е. внутренний запрос на создание карточки по шаблону и ответ на него. Внутренний запрос может иметь значение null, если его не удалось создать.

См. также