/ doc / DocFrag / ARCCore.PropertyStreamLine.TryStore / Description

Description

Edit keys at this level only

= Stores the given -PropertyStreamLineParsed- in the given storage object.0x000D0x000A0x000D0x000AThis is AgoRapide's main deserialization mechanism (together with -TryParse-).0x000D0x000AThe main serialization mechanism is -ToPropertyStream-0x000D0x000A0x000D0x000ASupposed to be called repeatedly by some mechanism listening to the -PropertyStream-, resulting in a 'complete' object representation being built up.0x000D0x000AThat is, turning the very basic -PropertyStreamLine- format into a more usable object oriented format for in-memory processing of data.0x000D0x000A0x000D0x000ATODO: Build in support for transactions. See for -PropertyStream- TODO: 'FAQ: Can the property stream format support transactions'0x000D0x000ATODO: for an outline about how this can be done.0x000D0x000ATODO: Consider having short-cut 'SetML' in IP (SetML = Set multi-level) which just calls this method.0x000D0x000A0x000D0x000AParses the actual property-value (-Value-) with help of -TryValidateAndParse- (if a corresponding -PK- is found. 0x000D0x000APossible fail scenarios are:0x000D0x000A0x000D0x000A1) Creation of hierarchical keys. Call to -TrySetP- may fail.0x000D0x000ANote that in general no validation is done for the keys, so for instance a misspelling of Customer as 'Customr/42/FirstName = John' will be accepted and stored accordingly (unless the actual storage has implemented some restrictions for what keys to accept).0x000D0x000A0x000D0x000A2) The final value parsing (and then only if a -PK- is found). Call to -TryValidateAndParse- may fail.0x000D0x000A0x000D0x000A3) The final value setting. Call to -TrySetP- may fail.0x000D0x000A0x000D0x000AThe value is stored by call to -TrySetP-.0x000D0x000AThis means that repeated occurrences of the same value will overwrite older ones.0x000D0x000AExample, for the following property stream lines:0x000D0x000A'Customer/42/FirstName = John'0x000D0x000A'...' (some other property stream lines)0x000D0x000A'Customer/42/FirstName = Johnny'0x000D0x000Athe final value of Customer/42/FirstName will be 'Johnny'.0x000D0x000A0x000D0x000ANote that the parsing concept is inherently not thread-safe and this method should therefore only be called within a single-threaded context (see -SingleThreadedCode-).0x000D0x000A

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

Generated 2025-09-19 16:15:04.160 UTC