/ doc / tocNamespace / ARCQuery / NewKey / __TOCDet / Description

Description

Edit keys at this level only

= A function creating new keys (new fields) that can be used against all object types in AgoRapide (against all entities).0x000D0x000A0x000D0x000ACompares roughly to the concept of Extension methods in C#.0x000D0x000ATODO: Possible rename into ExtensionKey (???)0x000D0x000A0x000D0x000AThis is an expandable concept, that is, you can create your own implementations of this class in your -ApplicationSpecificCode-.0x000D0x000A0x000D0x000ANote that more usually than not, you should create a new -EntityMethodKey- (valid for a single entity type) instead of a new -NewKey- (valid for all object types).0x000D0x000A0x000D0x000AIn other words, there is no point in creating new implementations of -NewKey- when you can instead just create a TryGet0x007BKey0x007D-method directly in your class which gets picked up by -EntityMethodKey-.0x000D0x000APractical example: If you have a class Customer with FirstName and LastName, do not create NewKeyName, create instead Customer.TryGetName.0x000D0x000A0x000D0x000AThere are very few implementing class in -StandardAgoRapideCode-:0x000D0x000A-NewKeyCountP- (returns the number of properties for a given entity object),0x000D0x000A-NewKeyCountPRec- (returns the number of properties for a given entity object, operates recursively),0x000D0x000A-NewKeyToPropertyStream- (returns the -PropertyStream- for the given object),0x000D0x000A-NewKeyGetType- (returns the internal C# object type of the given object)0x000D0x000A0x000D0x000ATODO: Add a -PK- field, describing the value that is returned.0x000D0x000A0x000D0x000ANote that will only come into play when explicit referenced, like 'SELECT *, CountP' for calling -NewKeyCountP-.

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

Generated 2025-09-16 12:38:17.387 UTC