Class RowError

Represents an error that occurred when processing a dataflow row. Multiple RowError instances can be used to represent multiple errors from different workers for a particular row.

RowError instances are created by calling one of the SendErrorRow(TError, String, Nullable<Int64>, String, Exception) overloads. Also see RowErrorCollection and CaptureRowErrors.

Inheritance
Object
RowError
Namespace: actionETL
Assembly: actionETL.dll
Syntax
public class RowError

Properties

ColumnName

Gets the name of the column that caused the error, or null if the error could not be assigned to a single column (the Message property should describe the error reason).

Declaration
public string ColumnName { get; }
Property Value
Type Description
String

Exception

Gets the exception that caused the error, or null if not applicable.

Note that the instance could be of any type derived from Exception, such as ArgumentException, InvalidOperationException etc.

Warning: Do not modify any exception properties and do not re-throw them after cloning them (e.g. via MulticastTransform<TInputOutput>), since this would lead to other copies also being changed. Exceptions contain mutable (i.e. modifiable) properties, but the dataflow treats the exception in this property as immutable (i.e. not modifiable) when cloning them, since deep copies cannot be reliably done on arbitrary exceptions.

Declaration
public Exception Exception { get; }
Property Value
Type Description
Exception

Locator

Gets the locator for the port or worker most closely associated with the error.

Declaration
public string Locator { get; }
Property Value
Type Description
String

Message

Gets the message describing the error.

Declaration
public string Message { get; }
Property Value
Type Description
String

RowNumber

Gets the row number, or null if not applicable.

The meaning of the row number depends on where the row is coming from, e.g.:

  • A source worker reading a CSV file would use the line number of the offending line in the source file as the row number. The first data line would have row number 1.
  • A transform or target worker that sends the incoming rows to its output without aggregation would use the RowsTaken property

Declaration
public long? RowNumber { get; }
Property Value
Type Description
Nullable<Int64>

Methods

ToString()

Returns a String that represents this instance.

Declaration
public override string ToString()
Returns
Type Description
String
Overrides

See Also