RuntimeExtensionsReportErrorSafeAsync - метод |
Сообщает об ошибке с заданными параметрами и с необязательным дополнительным описанием, в т.ч. с файлами.
Для ошибки создаётся карточка с детальным описанием и с заданным идентификатором,
в которой можно выполнять поиск по категории и тексту.
Если при отправке ошибки возникло любое исключение, то оно поглощается
и заносится в лог
Error
Метод возвращает идентификатор фактически созданной ошибки
или
null, если при отправке ошибки возникло исключение.
Пространство имён:
Tessa.Platform.Runtime
Сборка:
Tessa (в Tessa.dll) Версия: 3.5.0.19
Синтаксис public static Task<Guid?> ReportErrorSafeAsync(
this IErrorManager errorManager,
Guid cardTypeID,
Guid cardID,
string cardName,
IErrorDescription description = null,
IErrorDetails details = null,
Guid? id = null,
bool withoutTransaction = false,
CancellationToken cancellationToken = default
)
<ExtensionAttribute>
Public Shared Function ReportErrorSafeAsync (
errorManager As IErrorManager,
cardTypeID As Guid,
cardID As Guid,
cardName As String,
Optional description As IErrorDescription = Nothing,
Optional details As IErrorDetails = Nothing,
Optional id As Guid? = Nothing,
Optional withoutTransaction As Boolean = false,
Optional cancellationToken As CancellationToken = Nothing
) As Task(Of Guid?)
public:
[ExtensionAttribute]
static Task<Nullable<Guid>>^ ReportErrorSafeAsync(
IErrorManager^ errorManager,
Guid cardTypeID,
Guid cardID,
String^ cardName,
IErrorDescription^ description = nullptr,
IErrorDetails^ details = nullptr,
Nullable<Guid> id = nullptr,
bool withoutTransaction = false,
CancellationToken cancellationToken = CancellationToken()
)
[<ExtensionAttribute>]
static member ReportErrorSafeAsync :
errorManager : IErrorManager *
cardTypeID : Guid *
cardID : Guid *
cardName : string *
?description : IErrorDescription *
?details : IErrorDetails *
?id : Nullable<Guid> *
?withoutTransaction : bool *
?cancellationToken : CancellationToken
(* Defaults:
let _description = defaultArg description null
let _details = defaultArg details null
let _id = defaultArg id null
let _withoutTransaction = defaultArg withoutTransaction false
let _cancellationToken = defaultArg cancellationToken new CancellationToken()
*)
-> Task<Nullable<Guid>>
Параметры
- errorManager
- Тип: Tessa.Platform.RuntimeIErrorManager
Объект, выполняющий отправку ошибки. Не должен быть равен null. - cardTypeID
- Тип: SystemGuid
Идентификатор типа карточки, с которым связана ошибка. - cardID
- Тип: SystemGuid
Идентификатор экземпляра карточки, с которым связана ошибка. - cardName
- Тип: SystemString
Отображаемое имя (или Digest) экземпляра карточки, с которым связана ошибка. - description (Optional)
- Тип: Tessa.Platform.RuntimeIErrorDescription
Описание ошибки или null, если дополнительной информации по ошибке не предоставляется.
- details (Optional)
- Тип: Tessa.Platform.RuntimeIErrorDetails
Дополнительное описание ошибки или null, если дополнительной информации по ошибке не предоставляется.
- id (Optional)
- Тип: SystemNullableGuid
Идентификатор ошибки или null, если генерируется новый идентификатор.
- withoutTransaction (Optional)
- Тип: SystemBoolean
Признак того, что транзакция принудительно не должна открываться.
Параметр актуален только на сервере.
- cancellationToken (Optional)
- Тип: System.ThreadingCancellationToken
Объект, посредством которого можно отменить асинхронную задачу.
Возвращаемое значение
Тип:
TaskNullableGuidАсинхронная задача.
Возвращаемое значение
Тип:
TaskNullableGuidИдентификатор фактически отправленной ошибки.
Примечание об использовании
В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа
IErrorManager. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе
Методы расширения (Visual Basic) или
Методы расширения (Руководство по программированию в C#).
См. также