Class UnconsumedCheckSyntax
Emits diagnostic warnings for content remaining after all upstream syntaxes have run: unconsumed Parsing entries and non-empty UnparsedText. Flags listed in ExcludedFlags are silently ignored. Must be placed at the end of NcSyntaxList.
public class UnconsumedCheckSyntax : ISituNcSyntax, INcSyntax, IMakeXmlSource
- Inheritance
-
UnconsumedCheckSyntax
- Implements
- Inherited Members
- Extension Methods
Constructors
UnconsumedCheckSyntax()
Creates a checker with an empty ExcludedFlags set.
public UnconsumedCheckSyntax()
UnconsumedCheckSyntax(XElement)
Loads excluded flag names from <Exclude> child elements.
public UnconsumedCheckSyntax(XElement src)
Parameters
Properties
ExcludedFlags
Parsing flags/keys that are known but intentionally unhandled.
public HashSet<string> ExcludedFlags { get; set; }
Property Value
Name
Syntax kind name (typically the concrete type name).
public string Name { get; }
Property Value
XName
XML element name for Regs registration.
public static string XName { get; }
Property Value
Methods
Build(LazyLinkedListNode<SyntaxPiece>, List<INcDependency>, NcDiagnosticProgress)
Build syntax arrangement into the
syntaxPieceNode in-place.
public void Build(LazyLinkedListNode<SyntaxPiece> syntaxPieceNode, List<INcDependency> ncDependencyList, NcDiagnosticProgress ncDiagnosticProgress)
Parameters
syntaxPieceNodeLazyLinkedListNode<SyntaxPiece>ncDependencyListList<INcDependency>ncDiagnosticProgressNcDiagnosticProgress
MakeXmlSource(string, string, bool)
Creates an XML representation of the object. This method may also generate additional resources such as related files.
public XElement MakeXmlSource(string baseDirectory, string relFile, bool exhibitionOnly)
Parameters
baseDirectorystringThe base directory for resolving relative paths
relFilestringThe relative file path for the XML source
exhibitionOnlyboolif true, the extended file creation is suppressed.
Returns
- XElement
An XML element representing the object's state
Remarks
For the demand of easy moving source folder (especially project folder) without configuration file path corruption, the relative file path is applied.
The baseDirectory is typically the folder at the nearest configuration file folder.
Since the folder can be moving with the configuration file.