/ doc / toc / ARCCore / Class / PropertyStreamLineParsed

PropertyStreamLineParsed

Edit keys at this level only

Edit keys at all sub levels.
NOTE: Edits are always additive. Use 'Invalid' in order to delete keys.

__TOCDet/Assembly = ARCCore
__TOCDet/Description = Parses the keys part of a line from -PropertyStream-, like 'Customer/42/FirstName = John.0x000D0x000A0x000D0x000AShould only be used in ephemeral contexts as class is assumed to be somewhat memory hungry.0x000D0x000A0x000D0x000AIn general, property stream lines should be stored as string only by -CoreDB- (and possible also -ArmDB-).0x000D0x000A-Client- will normally use -PropertyStreamLineParsed- as a middle step in order to to translate the string representation of a -PropertyStreamLine- into a hierarhical data storage.0x000D0x000A
__TOCDet/DocFragType = Class
__TOCDet/Name = PropertyStreamLineParsed
__TOCDet/Namespace = ARCCore
__TOCDet/Type = PropertyStreamLineParsed
__TOCDet/Attribute/AssemblyName = ARCCore
__TOCDet/Attribute/ClassNamespace = ARCCore
__TOCDet/Attribute/ClassType = PropertyStreamLineParsed
__TOCDet/Attribute/Description = Parses the keys part of a line from -PropertyStream-, like 'Customer/42/FirstName = John.0x000D0x000A0x000D0x000AShould only be used in ephemeral contexts as class is assumed to be somewhat memory hungry.0x000D0x000A0x000D0x000AIn general, property stream lines should be stored as string only by -CoreDB- (and possible also -ArmDB-).0x000D0x000A-Client- will normally use -PropertyStreamLineParsed- as a middle step in order to to translate the string representation of a -PropertyStreamLine- into a hierarhical data storage.0x000D0x000A
IsComment/__TOCDet/Assembly = ARCCore
IsComment/__TOCDet/Description = Signifies that property stream line given for parsing started with '//' (two forward slashes).0x000D0x000A0x000D0x000AIf TRUE then this object contains no data
IsComment/__TOCDet/DocFragType = ClassMember
IsComment/__TOCDet/IsInherited = False
IsComment/__TOCDet/IsInheritedDoc = False
IsComment/__TOCDet/Lines = 3
IsComment/__TOCDet/Name = IsComment
IsComment/__TOCDet/Namespace = ARCCore
IsComment/__TOCDet/Type = PropertyStreamLineParsed
IsComment/__TOCDet/Attribute/DeclaringType = PropertyStreamLineParsed
IsComment/__TOCDet/Attribute/Description = Signifies that property stream line given for parsing started with '//' (two forward slashes).0x000D0x000A0x000D0x000AIf TRUE then this object contains no data
IsComment/__TOCDet/Attribute/MethodName = IsComment
IsComment/__TOCDet/Attribute/MethodSignature = Boolean IsComment
Keys/__TOCDet/Assembly = ARCCore
Keys/__TOCDet/Description = The keys part of the -PropertyStreamLine-, that is, everything before ' = '.0x000D0x000ANote that tuple item valueType will always be of an -IP- type.0x000D0x000A0x000D0x000AvalueType will not be set for the last List item.0x000D0x000AvalueType is not in that position because calling method will use -TryValidateAndParse- which picks up the key from the -PK-.0x000D0x000AAnd also, because we guarantee that valueType is only an IP-based type and pk.Type can be any type, it can not be set anyway.
Keys/__TOCDet/DocFragType = ClassMember
Keys/__TOCDet/IsInherited = False
Keys/__TOCDet/IsInheritedDoc = False
Keys/__TOCDet/Lines = 6
Keys/__TOCDet/Name = Keys
Keys/__TOCDet/Namespace = ARCCore
Keys/__TOCDet/Type = PropertyStreamLineParsed
Keys/__TOCDet/Attribute/DeclaringType = PropertyStreamLineParsed
Keys/__TOCDet/Attribute/Description = The keys part of the -PropertyStreamLine-, that is, everything before ' = '.0x000D0x000ANote that tuple item valueType will always be of an -IP- type.0x000D0x000A0x000D0x000AvalueType will not be set for the last List item.0x000D0x000AvalueType is not in that position because calling method will use -TryValidateAndParse- which picks up the key from the -PK-.0x000D0x000AAnd also, because we guarantee that valueType is only an IP-based type and pk.Type can be any type, it can not be set anyway.
Keys/__TOCDet/Attribute/MethodName = Keys
Keys/__TOCDet/Attribute/MethodSignature = System.Collections.Generic.List0x006010x005BSystem.ValueTuple0x006020x005BARCCore.IK,System.Type0x005D0x005D Keys
ToString/__TOCDet/Assembly = ARCCore
ToString/__TOCDet/Description = Note relatively complex operation of 'restoring' original property stream line.0x000D0x000AShould probably only be used in debugging or failure scenarios.
ToString/__TOCDet/DocFragType = ClassMember
ToString/__TOCDet/IsInherited = False
ToString/__TOCDet/IsInheritedDoc = False
ToString/__TOCDet/Lines = 2
ToString/__TOCDet/Name = ToString
ToString/__TOCDet/Namespace = ARCCore
ToString/__TOCDet/Type = PropertyStreamLineParsed
ToString/__TOCDet/Attribute/DeclaringType = PropertyStreamLineParsed
ToString/__TOCDet/Attribute/Description = Note relatively complex operation of 'restoring' original property stream line.0x000D0x000AShould probably only be used in debugging or failure scenarios.
ToString/__TOCDet/Attribute/MethodName = ToString
ToString/__TOCDet/Attribute/MethodSignature = System.String ToString()
TryParse/__TOCDet/Assembly = ARCCore
TryParse/__TOCDet/Description = Generate list of 0x003C(IK key, Type valueType)0x003E together with value from value part.0x000D0x000A0x000D0x000AHas very few fail-scenarios (that is will almost always return TRUE).0x000D0x000ANote that the value itself will not be parsed (it is just returned in -Value- as a 'string?').0x000D0x000A0x000D0x000Athe valueType returned will always be an -IP- type.0x000D0x000A(but null for last key in hierarchy).0x000D0x000A0x000D0x000AThis is the first step in parsing a -PropertyStreamLine-, typically used by more higher level methods like0x000D0x000A-TryParseAndStore-,0x000D0x000A-TryParseDirectToIP-,0x000D0x000A-TryParseDirectToProperty-.0x000D0x000A0x000D0x000ANote that if the value part consists of individual items, like in -WholeCollection-, each of these has to be decoded individually again by the calling method (by calling -Decode-).0x000D0x000A0x000D0x000ADetails: For each key, decide which instance type of -IK- to use, that is, once of -PK-, -IKType-, -IKString- (or -IKLong- if an integer) in prioritized order).0x000D0x000A0x000D0x000AThe following priority is used for deciding -IK--keys:0x000D0x000A1) -PK- if a -PK- is recognized (like FirstName in 'Customer/42/FirstName:', based on a combination of found type 'Customer' and field 'FirstName')0x000D0x000A0x000D0x000A2) -IKType- if a -IP--derived type is recognized.0x000D0x000A(like 'Customer' in 'Customer/42/FirstName:')0x000D0x000A0x000D0x000A3) -IKString- for other cases (-IKLong- if an integer) .0x000D0x000A(like 42 in 'Custome/42/FirstName:'0x000D0x000A0x000D0x000AFor each key, decide what type of value-object to create if no object exists for that key (dedicated type like 'CustomerCollection' or 'Customer' if possible, if not -PRich-)0x000D0x000A0x000D0x000A        For 'Customer/42/FirstName = John', the tuple generated will look like this:0x000D0x000A        (which of the two alternative values are returned (IKType or IKString) depends on the actual type being known to the application (see -AllIPDerivedTypes-).0x000D0x000A        ---------------------------------------------------------------------------------------------------------0x000D0x000A                            key:                                                          valueType0x000D0x000A        Index 0 Customer    IKType(typeof(Customer)) / IKString('Customer')               CustomerCollection, alternatively PRich0x000D0x000A        Index 1 42          IKLong(42) (since integer, else IKString('42'))               Customer / PRich0x000D0x000A        Index 2 FirstName   PK (from CustomerP.FirstName) / IKString('FirstName')         Null. Left to IP to decide at call to SetP.0x000D0x000A0x000D0x000A        For 'Customer/42/PhoneNumber/90534333'  ('strange' syntax is related to -IndividualItems-), 0x000D0x000A        the tuple generated will look like this:0x000D0x000A        (which of the two alternative values are returned (IKType or IKString) depends on the actual type being known to the application (see -AllIPDerivedTypes-).0x000D0x000A        ---------------------------------------------------------------------------------------------------------0x000D0x000A                            key:                                                          valueType0x000D0x000A        Index 0 Customer    IKType(typeof(Customer)) / IKString('Customer')               CustomerCollection, alternatively PRich0x000D0x000A        Index 1 42          IKLong(42) (since integer, else IKString('42'))               Customer / PRich0x000D0x000A        Index 2 PhoneNumber PK (from CustomerP.PhoneNumber) / IKString('PhoneNumber')     Null. Left to IP to decide at call to SetP.0x000D0x000A0x000D0x000ANote that more complex representations like:0x000D0x000A  Customer/42/Car/1/Colour = Red0x000D0x000Ais also understood.0x000D0x000ASo if CustomerP.Car exists then for 'Car' that corresponding PK will be used, while for '1' the type to create will be the the PK's Type.0x000D0x000A0x000D0x000AThe above would be relevant for cardinality -IndividualItems- for CustomerP.Car).0x000D0x000AFor cardinality -HistoryOnly-, as in0x000D0x000A  Customer/42/Car/Colour = Red0x000D0x000Athen for 'Car' the corresponding CustomerP.Car will be used (as above), and for Colour the corresponding PK for CarP.Colour.0x000D0x000A0x000D0x000ASee also -TryParseDtr- which can deserialize whole records.0x000D0x000A
TryParse/__TOCDet/DocFragType = ClassMember
TryParse/__TOCDet/IsInherited = False
TryParse/__TOCDet/IsInheritedDoc = False
TryParse/__TOCDet/Lines = 57
TryParse/__TOCDet/Name = TryParse
TryParse/__TOCDet/Namespace = ARCCore
TryParse/__TOCDet/Type = PropertyStreamLineParsed
TryParse/__TOCDet/Attribute/DeclaringType = PropertyStreamLineParsed
TryParse/__TOCDet/Attribute/Description = Generate list of 0x003C(IK key, Type valueType)0x003E together with value from value part.0x000D0x000A0x000D0x000AHas very few fail-scenarios (that is will almost always return TRUE).0x000D0x000ANote that the value itself will not be parsed (it is just returned in -Value- as a 'string?').0x000D0x000A0x000D0x000Athe valueType returned will always be an -IP- type.0x000D0x000A(but null for last key in hierarchy).0x000D0x000A0x000D0x000AThis is the first step in parsing a -PropertyStreamLine-, typically used by more higher level methods like0x000D0x000A-TryParseAndStore-,0x000D0x000A-TryParseDirectToIP-,0x000D0x000A-TryParseDirectToProperty-.0x000D0x000A0x000D0x000ANote that if the value part consists of individual items, like in -WholeCollection-, each of these has to be decoded individually again by the calling method (by calling -Decode-).0x000D0x000A0x000D0x000ADetails: For each key, decide which instance type of -IK- to use, that is, once of -PK-, -IKType-, -IKString- (or -IKLong- if an integer) in prioritized order).0x000D0x000A0x000D0x000AThe following priority is used for deciding -IK--keys:0x000D0x000A1) -PK- if a -PK- is recognized (like FirstName in 'Customer/42/FirstName:', based on a combination of found type 'Customer' and field 'FirstName')0x000D0x000A0x000D0x000A2) -IKType- if a -IP--derived type is recognized.0x000D0x000A(like 'Customer' in 'Customer/42/FirstName:')0x000D0x000A0x000D0x000A3) -IKString- for other cases (-IKLong- if an integer) .0x000D0x000A(like 42 in 'Custome/42/FirstName:'0x000D0x000A0x000D0x000AFor each key, decide what type of value-object to create if no object exists for that key (dedicated type like 'CustomerCollection' or 'Customer' if possible, if not -PRich-)0x000D0x000A0x000D0x000A        For 'Customer/42/FirstName = John', the tuple generated will look like this:0x000D0x000A        (which of the two alternative values are returned (IKType or IKString) depends on the actual type being known to the application (see -AllIPDerivedTypes-).0x000D0x000A        ---------------------------------------------------------------------------------------------------------0x000D0x000A                            key:                                                          valueType0x000D0x000A        Index 0 Customer    IKType(typeof(Customer)) / IKString('Customer')               CustomerCollection, alternatively PRich0x000D0x000A        Index 1 42          IKLong(42) (since integer, else IKString('42'))               Customer / PRich0x000D0x000A        Index 2 FirstName   PK (from CustomerP.FirstName) / IKString('FirstName')         Null. Left to IP to decide at call to SetP.0x000D0x000A0x000D0x000A        For 'Customer/42/PhoneNumber/90534333'  ('strange' syntax is related to -IndividualItems-), 0x000D0x000A        the tuple generated will look like this:0x000D0x000A        (which of the two alternative values are returned (IKType or IKString) depends on the actual type being known to the application (see -AllIPDerivedTypes-).0x000D0x000A        ---------------------------------------------------------------------------------------------------------0x000D0x000A                            key:                                                          valueType0x000D0x000A        Index 0 Customer    IKType(typeof(Customer)) / IKString('Customer')               CustomerCollection, alternatively PRich0x000D0x000A        Index 1 42          IKLong(42) (since integer, else IKString('42'))               Customer / PRich0x000D0x000A        Index 2 PhoneNumber PK (from CustomerP.PhoneNumber) / IKString('PhoneNumber')     Null. Left to IP to decide at call to SetP.0x000D0x000A0x000D0x000ANote that more complex representations like:0x000D0x000A  Customer/42/Car/1/Colour = Red0x000D0x000Ais also understood.0x000D0x000ASo if CustomerP.Car exists then for 'Car' that corresponding PK will be used, while for '1' the type to create will be the the PK's Type.0x000D0x000A0x000D0x000AThe above would be relevant for cardinality -IndividualItems- for CustomerP.Car).0x000D0x000AFor cardinality -HistoryOnly-, as in0x000D0x000A  Customer/42/Car/Colour = Red0x000D0x000Athen for 'Car' the corresponding CustomerP.Car will be used (as above), and for Colour the corresponding PK for CarP.Colour.0x000D0x000A0x000D0x000ASee also -TryParseDtr- which can deserialize whole records.0x000D0x000A
TryParse/__TOCDet/Attribute/MethodName = TryParse
TryParse/__TOCDet/Attribute/MethodSignature = Boolean TryParse(System.String, ARCCore.PropertyStreamLineParsed ByRef, System.String ByRef)
Value/__TOCDet/Assembly = ARCCore
Value/__TOCDet/Description = The original (non-parsed, non-validated)) value part of the -PropertyStreamLine-, that is, everything after ' = '.0x000D0x000AWill be null if nothing found after ' = '.
Value/__TOCDet/DocFragType = ClassMember
Value/__TOCDet/IsInherited = False
Value/__TOCDet/IsInheritedDoc = False
Value/__TOCDet/Lines = 2
Value/__TOCDet/Name = Value
Value/__TOCDet/Namespace = ARCCore
Value/__TOCDet/Type = PropertyStreamLineParsed
Value/__TOCDet/Attribute/DeclaringType = PropertyStreamLineParsed
Value/__TOCDet/Attribute/Description = The original (non-parsed, non-validated)) value part of the -PropertyStreamLine-, that is, everything after ' = '.0x000D0x000AWill be null if nothing found after ' = '.
Value/__TOCDet/Attribute/MethodName = Value
Value/__TOCDet/Attribute/MethodSignature = System.String Value

Edit single sub keys only: __TOCDet / IsComment / Keys / ToString / TryParse / Value

Generated 2025-05-23 21:00:21.088 UTC