DrawingExceptionMode¶
Namespace: ThinkGeo.Core
Defines how drawing exceptions are handled during rendering.
public enum DrawingExceptionMode
Inheritance object → ValueType → Enum → DrawingExceptionMode
Implements IComparable, ISpanFormattable, IFormattable, IConvertible
Fields¶
| Name | Value | Description |
|---|---|---|
| Default | 4 | [Obsolete] Default mode used in the MapSuite component. |
Note: This value is deprecated and will be removed after v14.4.
Use one of the following modes instead:
, ,
, or . |
| DrawAndThrowException | 0 | Draws an error placeholder on the canvas and then rethrows the exception. Calling code can catch and handle the exception while still seeing a visual indication of the failure on the map. | | DrawException | 1 | Catches the exception and draws an error placeholder on the canvas, but does NOT rethrow it. This keeps the application running, at the cost of hiding the failure from the caller. Be careful when using this mode with tile caching: failed tiles may be cached with error content. | | ThrowException | 2 | Immediately rethrows the exception without drawing any error placeholder on the canvas. This mode is useful when you want the calling code to fully control error handling and logging. | | IgnoreException | 3 | Completely swallows the exception: nothing is drawn on the canvas and the exception is NOT rethrown. Rendering simply continues as if no error had occurred. This avoids interruptions but can make failures very hard to detect, especially when combined with tile caching, because bad tiles may be silently cached without any visual error. |