This version primarily focuses on reworking the concept of element Scope and how the Lookup/Index API works.
Scope was added as a complex class that contains all the information regarding the location of a given element in the L5X tree.
Scope includes the Controller name, Program and Routine name (when applicable), element Type, and element Name (or number in the case of code elements like rung). Therefore, Scope can be viewed as a sort of URI for an element.
Scope replaces ComponentKey for components and is also no longer exclusive to just components, but also to LogixCode elements as well.
The old Scope enum is now called ScopeLevel and instead of Instruction scope there is Routine scope.
ScopeType enum was added to identify the types of elements we are considering valid scope elements.
The internal LogixIndex class was reworked to support Scope.
This also led to redefining of the lookup API. I created a new interface called ILogixLookup which defines the API.
L5XOptions were added to allow user to specify if they want to index the file on load or not. If not the default is to use XPath lookup and not dictionary lookup which is less efficient.
CrossReference was reworked to use Scope, TagName, and Instruction only.
tnunnink
commented
1 month ago
This version primarily focuses on reworking the concept of element Scope and how the Lookup/Index API works.
Scopewas added as a complex class that contains all the information regarding the location of a given element in the L5X tree.Scopeincludes theControllername,ProgramandRoutinename (when applicable), elementType, and elementName(or number in the case of code elements like rung). Therefore, Scope can be viewed as a sort of URI for an element.ComponentKeyfor components and is also no longer exclusive to just components, but also toLogixCodeelements as well.ScopeLeveland instead ofInstructionscope there isRoutinescope.ScopeTypeenum was added to identify the types of elements we are considering valid scope elements.LogixIndexclass was reworked to support Scope.ILogixLookupwhich defines the API.L5XOptionswere added to allow user to specify if they want to index the file on load or not. If not the default is to use XPath lookup and not dictionary lookup which is less efficient.CrossReferencewas reworked to use Scope, TagName, and Instruction only.