Back to Devexpress

FieldOptions.ThrowExceptionOnInvalidFormatSwitch Property

officefileapi-devexpress-dot-xtrarichedit-dot-fieldoptions-1c75ab5c.md

latest2.5 KB
Original Source

FieldOptions.ThrowExceptionOnInvalidFormatSwitch Property

Gets or sets whether to throw exception if a field formatting switch is not recognized.

Namespace : DevExpress.XtraRichEdit

Assembly : DevExpress.RichEdit.v25.2.Core.dll

NuGet Package : DevExpress.RichEdit.Core

Declaration

csharp
[DefaultValue(true)]
public bool ThrowExceptionOnInvalidFormatSwitch { get; set; }
vb
<DefaultValue(True)>
Public Property ThrowExceptionOnInvalidFormatSwitch As Boolean

Property Value

TypeDefaultDescription
Booleantrue

True , to throw exception on an invalid field formatting switch; otherwise, false.

|

Property Paths

You can access this nested property as listed below:

Object TypePath to ThrowExceptionOnInvalidFormatSwitch
RichEditControlOptionsBase

.Fields .ThrowExceptionOnInvalidFormatSwitch

|

Remarks

The field update starts by parsing the Field.CodeRange content to obtain the field name and the field switches. If an attempt to recognize the field formatting switch fails with an exception, you can prevent the exception from propagation by setting the ThrowExceptionOnInvalidFormatSwitch property to false. In this situation, the field is calculated but the formatting switch is ignored.

Tip

Set the ThrowExceptionOnInvalidFormatSwitch property to false to open documents containing incorrect field codes.

See Also

Format Switches

FieldOptions Class

FieldOptions Members

DevExpress.XtraRichEdit Namespace