CardUIExtensionsCreateAndInitializeModelAsync - метод

Создаёт и инициализирует модель представления карточки с заданными параметрами. Созданная модель представления защищается от изменений посредством вызова Seal перед тем, как будет возвращена. Сразу после этого её можно присвоить в свойстве CardModel.

Definition

Пространство имён: Tessa.UI.Cards
Сборка: Tessa.UI (в Tessa.UI.dll) Версия: 4.0.4
C#
public static Task<ICardModel> CreateAndInitializeModelAsync(
	this ICardEditorModel editor,
	Card card,
	StringDictionaryStorage<CardRow> sectionRows = null,
	CardModelFlags flags = CardModelFlags.None,
	UIContextExecutorAsync contextExecutorAsync = null,
	CardModelSavingFuncAsync savingFuncAsync = null,
	IUIContext otherContext = null,
	Func<ICardModel, CancellationToken, Task> initializingModelActionAsync = null,
	Func<ICardModel, CancellationToken, Task> initializedModelActionAsync = null,
	CancellationToken cancellationToken = default
)

Параметры

editor  ICardEditorModel

Редактор карточек, посредством которого создаётся и инициализируется модель представления карточки.

Этот редактор может использоваться в дальнейшем для редактирования карточки, если результат этого метода будет присвоен в свойстве CardModel.

card  Card
Карточка, для которой требуется создать модель представления.
sectionRows  StringDictionaryStorageCardRow  (Optional)

Коллекция строк, используемых для создания новых строк в коллекционных и древовидных секциях карточки, или null, если такие строки не используются.

Рекомендуется указывать этот параметр для всех случаев, кроме тех, когда карточка не содержит редактируемых коллекционных или древовидных секций.

flags  CardModelFlags  (Optional)
Флаги, устанавливаемые для созданной модели представления.
contextExecutorAsync  UIContextExecutorAsync  (Optional)

Действие, выполняющее заданное действие в контексте IUIContext, или null, если используется действие по умолчанию.

Указание UnknownContextExecutorAsync(FuncIUIContext, CancellationToken, ValueTask, CancellationToken) позволяет выполнять действия в контексте Unknown.

savingFuncAsync  CardModelSavingFuncAsync  (Optional)

Функция, выполняющая сохранение карточки, или null, если используется функция по умолчанию.

Указание EmptySavingFuncAsync(ICardSavingRequest, CancellationToken) позволяет не выполнять действий при сохранении карточки.

otherContext  IUIContext  (Optional)
Контекст операции с пользовательским интерфейсом, который будет использоваться для расширений на инициализацию модели карточки (свойство context.UIContext, доступное внутри расширения). Если указано null, то будет использоваться контекст редактора editor.
initializingModelActionAsync  FuncICardModel, CancellationToken, Task  (Optional)
Метод, который может изменить созданную модель представления ICardModel перед тем, как будет создано UI и будут инициализированы расширения UI. Указание null позволяет не выполнять действий на этом этапе.
initializedModelActionAsync  FuncICardModel, CancellationToken, Task  (Optional)
Метод, который может изменить созданную модель представления ICardModel после того, как было создано UI и были инициализированы расширения UI. Указание null позволяет не выполнять действий на этом этапе.
cancellationToken  CancellationToken  (Optional)
Объект, посредством которого можно отменить асинхронную задачу.

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

TaskICardModel
Созданная модель представления карточки.

Примечание об использовании

В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа ICardEditorModel. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе Методы расширения (Visual Basic) или Методы расширения (Руководство по программированию в C#).

См. также