CardExtensionsTryAddTaskAsync - метод |
Создаёт и добавляет возвращаемое задание с заданными параметрами.
После создания может потребоваться заполнить секции задания и другие параметры
CardTask.
Возвращённый объект
ValidationResult содержит ошибки и сообщения, возникшие при создании задания, он всегда не равен
null.
Возвращённый объект
CardTask может быть равен
null, если при создании были ошибки.
В этом случае возвращённый объект
ValidationResult содержит эти ошибки.
Пространство имён:
Tessa.Cards
Сборка:
Tessa (в Tessa.dll) Версия: 3.5.0.19
Синтаксис public static Task<(CardTask task, ValidationResult result)> TryAddTaskAsync(
this ICardRepository cardRepository,
Card card,
Guid taskTypeID,
CardRowState state,
Guid roleID,
string roleName,
DateTime? planned = null,
string digest = null,
Guid? taskRowID = null,
CancellationToken cancellationToken = default
)
<ExtensionAttribute>
Public Shared Function TryAddTaskAsync (
cardRepository As ICardRepository,
card As Card,
taskTypeID As Guid,
state As CardRowState,
roleID As Guid,
roleName As String,
Optional planned As DateTime? = Nothing,
Optional digest As String = Nothing,
Optional taskRowID As Guid? = Nothing,
Optional cancellationToken As CancellationToken = Nothing
) As Task(Of (task As CardTask, result As ValidationResult))
public:
[ExtensionAttribute]
static Task<ValueTuple<CardTask^, ValidationResult^>>^ TryAddTaskAsync(
ICardRepository^ cardRepository,
Card^ card,
Guid taskTypeID,
CardRowState state,
Guid roleID,
String^ roleName,
Nullable<DateTime> planned = nullptr,
String^ digest = nullptr,
Nullable<Guid> taskRowID = nullptr,
CancellationToken cancellationToken = CancellationToken()
)
[<ExtensionAttribute>]
static member TryAddTaskAsync :
cardRepository : ICardRepository *
card : Card *
taskTypeID : Guid *
state : CardRowState *
roleID : Guid *
roleName : string *
?planned : Nullable<DateTime> *
?digest : string *
?taskRowID : Nullable<Guid> *
?cancellationToken : CancellationToken
(* Defaults:
let _planned = defaultArg planned null
let _digest = defaultArg digest null
let _taskRowID = defaultArg taskRowID null
let _cancellationToken = defaultArg cancellationToken new CancellationToken()
*)
-> Task<ValueTuple<CardTask, ValidationResult>>
Параметры
- cardRepository
- Тип: Tessa.CardsICardRepository
Репозиторий карточек, используемый для создания заданий. - card
- Тип: Tessa.CardsCard
Карточка, в которую должно быть добавлено задание. - taskTypeID
- Тип: SystemGuid
Тип создаваемого задания. - state
- Тип: Tessa.CardsCardRowState
Состояние созданного задания. Укажите Inserted
для того, чтобы задание можно было создать при сохранении.
- roleID
- Тип: SystemGuid
Идентификатор роли, на которое назначается задание. - roleName
- Тип: SystemString
Имя роли, на которое назначается задание. Может быть равно null,
если создание создаётся для сохранения, но не отображается пользователю.
- planned (Optional)
- Тип: SystemNullableDateTime
Дата запланированного завершения задания или null, если используется дата по умолчанию. - digest (Optional)
- Тип: SystemString
Digest созданного задания или null, если у задания отсутствует Digest. - taskRowID (Optional)
- Тип: SystemNullableGuid
Идентификатор созданного задания или null, если идентификатор будет сгенерирован. - cancellationToken (Optional)
- Тип: System.ThreadingCancellationToken
Объект, посредством которого можно отменить асинхронную задачу.
Возвращаемое значение
Тип:
TaskValueTupleCardTask,
ValidationResult
Результат создания задания, содержит ошибки и сообщения, возникшие при создании задания. Всегда не равен
null.
Примечание об использовании
В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа
ICardRepository. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе
Методы расширения (Visual Basic) или
Методы расширения (Руководство по программированию в C#).
См. также