ExpressionResolutionFlags Enumeration |
Namespace:
NetQuarry.Data
Assembly:
EAP.Core (in EAP.Core.dll) Version: 2.0.0.0 (4.6.8.0)
Syntax [FlagsAttribute]
public enum ExpressionResolutionFlags
<FlagsAttribute>
Public Enumeration ExpressionResolutionFlags
Members
| Member name | Value | Description |
---|
| ForFilterKey | 1 | Resolve the expression for use as a key in filtering. For internal use. |
| ParseEmbeddedFuncs | 2 | Resolve the expression for embedded functions. |
| VisibleFieldsOnly | 4 | Resolve references only for visible fields. Fields that are not visible will be resolved to blank strings. |
| AddExprModifier | 8 |
A data format modifier character should be inserted at the start of each reference substitution.
Currently this will be '$' for DisplayText data or '*' for raw value data. This flag is intended
for internal platform use and is not recommended for general use.
|
| UseOldValue | 16 | Use the field's old value when resolving. Applies to field references only. |
| ForJavaScript | 32 | Resolve the expression to a javascript statement. The primary effect is to double-quote DisplayText values. |
| EvalJavascript | 64 | After resolving the expression, evaluate it as a javascript expression. |
| DoNotThrow | 128 |
Do not throw an exception if expression includes unresolvable fields or syntax errors.
This is generally the desired behaviour, but, for historical reasons, the default behaviour is
to throw an error if such ananomaly is encountered.
If you do want such exceptions to be thrown you may want to set ThrowOnAnomaly for clarity.
Note that if both this attribute and ThrowOnAnomaly are set then this attribute will be ignored.
You may want to also set WriteErrToReqLog to log any errors that are not throw due to this
attribute (unless such problems are to be expected and you do not want them logged).
|
| EscapeForHtml | 256 |
Each field reference in the expression should be escaped for HTML except for those fields marked with HtmlContent.
Note that expression content outside of field references will not be escaped.
|
| UseCaption | 512 | Use the field's caption when resolving. Applies to field references only. |
| WriteErrToReqLog | 1024 |
If expression includes unresolvable fields or syntax errors any such error should be logged to the RequestLog.
This is generally combined with DoNotThrow.
|
| ThrowOnAnomaly | 2048 |
For historical reasons, the default behaviour is to throw an error if the expression includes unresolvable fields or
syntax errors. This is generally NOT the desired behaviour, but is maintained for historical reasons.
Typically you will want to set the DoNotThrow attribute.
This attribute is provided for clarity and for use in newer helper methods where the default behaviour is to
NOT throw such errors.
Note that if both this attribute and DoNotThrow are set then this attribute will be favored.
|
See Also