/ doc / tocNamespace / ARCQuery / NewKey

NewKey

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 = ARCQuery
__TOCDet/Description = 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-.
__TOCDet/DocFragType = Class
__TOCDet/Name = NewKey
__TOCDet/Namespace = ARCQuery
__TOCDet/Type = NewKey
__TOCDet/Attribute/AssemblyName = ARCQuery
__TOCDet/Attribute/BaseTypes = CompoundKey
__TOCDet/Attribute/ClassNamespace = ARCQuery
__TOCDet/Attribute/ClassType = NewKey
__TOCDet/Attribute/Description = 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-.
__TOCDet/Attribute/Interfaces = IK0x003BIEquatable0xoooo003CIK0xoooo003E0x003BITypeDescriber0x003BIEquatable0xoooo003CNewKey0xoooo003E
__TOCDet/Attribute/InterfacesDirectlyImplemented = IK0x003BIEquatable0xoooo003CIK0xoooo003E0x003BITypeDescriber0x003BIEquatable0xoooo003CNewKey0xoooo003E
__TOCDet/Attribute/SubTypes = NewKeyCountP0x003BNewKeyCountPRec0x003BNewKeyGetType0x003BNewKeyToPropertyStream

Edit single sub keys only: __TOCDet

Generated 2025-06-30 12:58:17.104 UTC