SnapControlCompatibility.DisableParameterNameValidation Property

Specifies whether to disable parameter name validation when loading .snx templates created in versions earlier than 14.2.8 and containing invalid symbols.

Namespace: DevExpress.Snap

Assembly: DevExpress.Snap.v21.2.Core.dll

NuGet Package: DevExpress.Snap.Core

Declaration

C#

[DefaultValue(false)]
public static bool DisableParameterNameValidation { get; set; }

VB.NET

<DefaultValue(False)>
Public Shared Property DisableParameterNameValidation As Boolean

Property Value

Type	Default	Description
Boolean	false	True, to disable parameter names validation; otherwise, false.

Remarks

By default, the name validation is enabled and loading a template with invalid symbols in parameter names results in an exception.

Note

A dot (one of the most commonly used symbol) is not permitted. A parameter name like Person.Nationalty containing a dot is invalid. You are advised to replace a dot (.) with an underscore (_). The space, percent sign and ampersand are also considered invalid symbols.

To load templates created in versions earlier than 14.2.8 and containing invalid symbols, do the following:

1. Set the DisableParameterNameValidation to true before loading a document.
2. Load the document.
3. Set the DisableParameterNameValidation property to false.
4. Replace invalid symbols manually or using the code that iterates over SnapDocument.Parameters and Field.CodeRange ranges of the document fields in the SubDocument.Fields collection.

Valid symbol categories are listed below:

• UnicodeCategory.UppercaseLetter
• UnicodeCategory.LowercaseLetter
• UnicodeCategory.TitlecaseLetter
• UnicodeCategory.ModifierLetter
• UnicodeCategory.OtherLetter
• UnicodeCategory.ConnectorPunctuation
• UnicodeCategory.DecimalDigitNumber
• UnicodeCategory.LetterNumber
• UnicodeCategory.OtherNumber