.NET API
TraconAgentSourceException
Tracon.Abstractions.dllRepresents a normalized failure from an IAgentSource.
public sealed class TraconAgentSourceException : TraconException, ISerializableInheritance
Section titled “Inheritance”object ← Exception ← TraconException ← TraconAgentSourceException
Implements
Section titled “Implements”Inherited Members
Section titled “Inherited Members”TraconException.ErrorType, Exception.GetBaseException(), Exception.ToString(), Exception.GetType(), Exception.TargetSite, Exception.Message, Exception.Data, Exception.InnerException, Exception.HelpLink, Exception.Source, Exception.HResult, Exception.StackTrace, object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Constructors
Section titled “Constructors”TraconAgentSourceException(string, string, string, Exception?)
Section titled “ TraconAgentSourceException(string, string, string, Exception?)”Creates a normalized agent-source exception.
public TraconAgentSourceException(string sourceName, string errorType, string message, Exception? innerException = null)Parameters
Section titled “Parameters”sourceName string
The stable name of the source that failed.
errorType string
The stable error type code.
message string
The normalized error message.
innerException Exception?
The raw underlying error, or null for a contract violation the catalog itself detected, which has no underlying exception to carry.
Fields
Section titled “Fields”SourceContractErrorType
Section titled “ SourceContractErrorType”The stable code for a source contract violation.
public const string SourceContractErrorType = "agent_source_contract"Field Value
Section titled “Field Value”SourceFailedErrorType
Section titled “ SourceFailedErrorType”The stable code for an ordinary source failure.
public const string SourceFailedErrorType = "agent_source_failed"Field Value
Section titled “Field Value”Properties
Section titled “Properties”ErrorType
Section titled “ ErrorType”Gets the stable error type name written to the run record.
public override string ErrorType { get; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”Defaults to the full name of the exception type, so today’s behaviour does
not change. A derived type overrides this member when the record has to be
machine readable — for example TraconContentFilteredException
writes content_filtered. Reports and alert rules can rely on this
stable name instead of an assembly name.
The value is written to RunError.Type and carries no secret.
SourceName
Section titled “ SourceName”Gets the stable name of the source that failed.
public string SourceName { get; }