Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

FieldOptions.ThrowExceptionOnInvalidFormatSwitch Property

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

Namespace: DevExpress.XtraRichEdit

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

NuGet Package: DevExpress.RichEdit.Core

#Declaration

[DefaultValue(true)]
public bool ThrowExceptionOnInvalidFormatSwitch { get; set; }

#Property Value

Type Default Description
Boolean true

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

#Property Paths

You can access this nested property as listed below:

Object Type Path 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