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 = IK = Interface Key / Index key. Key used to lookup 'inside' an instance of -IP-.0x000D0x000A0x000D0x000ATODO: Consider renaming into IIK (Interface index key).0x000D0x000A0x000D0x000AImlementing classes in -StandardAgoRapideCode- are:0x000D0x000A-IKString-: Index key for any general id, like primary-key,0x000D0x000A-IKLong-: A more memory efficient alternative to -IKString-,0x000D0x000A-IKType-: Used when storing a collection of a given type,0x000D0x000A-IIKII-: Related to -PII-, property for storing individual items,0x000D0x000A-PK-: PK = AgoRapide PropertyKey. Describes properties related to an object (an entity),0x000D0x000A-NewKey-: (In -ARCQuery-), A function creating new keys (new fields).0x000D0x000A0x000D0x000AThe key is what describes the different elements in a -PropertyStreamLine- line.0x000D0x000A0x000D0x000AExample for how different implementing classes are chosen for a specific -PropertyStreamLine- like0x000D0x000A'dt/Customer/42/PhoneNumber = 90534333':0x000D0x000A0x000D0x000A'dt' would correspond to -dt- (data). Parsed as -IKString-0x000D0x000A(if the data storage is implicitly storing only data then this prefix will often have been removed before parsing the rest of the keys).0x000D0x000A0x000D0x000A'Customer' would be a -IKType-, that is a key pointing to a collection of all objects of type 'Customer'.0x000D0x000A(in RDBMS-terms pointing to a table called Customers)0x000D0x000A0x000D0x000A'42' would be a -IKLong- (-IKString- if it had not been an integer), that is, a general identifier for a specific entity.0x000D0x000A(in RDBMS-terms a primary key)0x000D0x000A0x000D0x000A'PhoneNumber' would be a -PK-, describing this specific field, and how the value '90534333' should be validated and parsed.0x000D0x000A(in RDBMS-terms the Field in the schema for the Table)0x000D0x000A0x000D0x000AInstances implementing this interface is suitable for use as key in hierarchical object stores like -PRich-.0x000D0x000A0x000D0x000ASee -TryParse- for details about about how the different sub-classes of IK are utilizied for a given -PropertyStreamLine-.0x000D0x000A
__TOCDet/DocFragType = Class
__TOCDet/LongDescription = All implementations are supposed to be immutable.0x000D0x000A0x000D0x000ASome notes about IEquatable0x003CIK0x003E:0x000D0x000A0x000D0x000ANote how IEquatable0x003CIK0x003E must be implemented in the different implementing classes0x000D0x000A(like -Equals-, -Equals- and -Equals-).0x000D0x000A0x000D0x000AEquality is always based on the string representation (-ToString-) because -IKString- may be used instead of -IKType- or -PK- (for instance depending on whether we have -StandardAgoRapideCode- or -ApplicationSpecificCode-).0x000D0x000A(in other words, a -IKString- must be seen as equal to a -IKType- or even -PK-.)0x000D0x000A0x000D0x000ANote how GetHashCode is also essential to implement. If not then dictionaries with this class as key will simply not work 0x000D0x000A(see -GetHashCode-, -GetHashCode-, and -GetHashCode-).0x000D0x000A0x000D0x000ALike Equality, GetHashCode is also based on the string representation (-ToString-). Same reason as above.0x000D0x000A0x000D0x000ANote that default implementation of Equals(IK other) and GetHashCode() in this interface is not possible (because these methods are implemented for any class anyway (as -Equals- / -GetHashCode-), so that would take precedence over a default interface method).0x000D0x000A0x000D0x000ANote that although this interface does not specify any maximum length of the string representation of the key (especially -IKString-) keys should be kept reasonable short in order to be practical in URL's and as file and folder names when storing on disk.0x000D0x000ASee -IKCoded- which specifies a maximum of 250 characters in an encoded string representation of a key.
__TOCDet/Name = IK
__TOCDet/Namespace = ARCCore
__TOCDet/Type = IK
__TOCDet/Attribute/AssemblyName = ARCCore
__TOCDet/Attribute/ClassNamespace = ARCCore
__TOCDet/Attribute/ClassType = IK
__TOCDet/Attribute/Description = IK = Interface Key / Index key. Key used to lookup 'inside' an instance of -IP-.0x000D0x000A0x000D0x000ATODO: Consider renaming into IIK (Interface index key).0x000D0x000A0x000D0x000AImlementing classes in -StandardAgoRapideCode- are:0x000D0x000A-IKString-: Index key for any general id, like primary-key,0x000D0x000A-IKLong-: A more memory efficient alternative to -IKString-,0x000D0x000A-IKType-: Used when storing a collection of a given type,0x000D0x000A-IIKII-: Related to -PII-, property for storing individual items,0x000D0x000A-PK-: PK = AgoRapide PropertyKey. Describes properties related to an object (an entity),0x000D0x000A-NewKey-: (In -ARCQuery-), A function creating new keys (new fields).0x000D0x000A0x000D0x000AThe key is what describes the different elements in a -PropertyStreamLine- line.0x000D0x000A0x000D0x000AExample for how different implementing classes are chosen for a specific -PropertyStreamLine- like0x000D0x000A'dt/Customer/42/PhoneNumber = 90534333':0x000D0x000A0x000D0x000A'dt' would correspond to -dt- (data). Parsed as -IKString-0x000D0x000A(if the data storage is implicitly storing only data then this prefix will often have been removed before parsing the rest of the keys).0x000D0x000A0x000D0x000A'Customer' would be a -IKType-, that is a key pointing to a collection of all objects of type 'Customer'.0x000D0x000A(in RDBMS-terms pointing to a table called Customers)0x000D0x000A0x000D0x000A'42' would be a -IKLong- (-IKString- if it had not been an integer), that is, a general identifier for a specific entity.0x000D0x000A(in RDBMS-terms a primary key)0x000D0x000A0x000D0x000A'PhoneNumber' would be a -PK-, describing this specific field, and how the value '90534333' should be validated and parsed.0x000D0x000A(in RDBMS-terms the Field in the schema for the Table)0x000D0x000A0x000D0x000AInstances implementing this interface is suitable for use as key in hierarchical object stores like -PRich-.0x000D0x000A0x000D0x000ASee -TryParse- for details about about how the different sub-classes of IK are utilizied for a given -PropertyStreamLine-.0x000D0x000A
__TOCDet/Attribute/Interfaces = IEquatable0xoooo003CIK0xoooo003E0x003BITypeDescriber
__TOCDet/Attribute/InterfacesDirectlyImplemented = IEquatable0xoooo003CIK0xoooo003E0x003BITypeDescriber
__TOCDet/Attribute/LongDescription = All implementations are supposed to be immutable.0x000D0x000A0x000D0x000ASome notes about IEquatable0x003CIK0x003E:0x000D0x000A0x000D0x000ANote how IEquatable0x003CIK0x003E must be implemented in the different implementing classes0x000D0x000A(like -Equals-, -Equals- and -Equals-).0x000D0x000A0x000D0x000AEquality is always based on the string representation (-ToString-) because -IKString- may be used instead of -IKType- or -PK- (for instance depending on whether we have -StandardAgoRapideCode- or -ApplicationSpecificCode-).0x000D0x000A(in other words, a -IKString- must be seen as equal to a -IKType- or even -PK-.)0x000D0x000A0x000D0x000ANote how GetHashCode is also essential to implement. If not then dictionaries with this class as key will simply not work 0x000D0x000A(see -GetHashCode-, -GetHashCode-, and -GetHashCode-).0x000D0x000A0x000D0x000ALike Equality, GetHashCode is also based on the string representation (-ToString-). Same reason as above.0x000D0x000A0x000D0x000ANote that default implementation of Equals(IK other) and GetHashCode() in this interface is not possible (because these methods are implemented for any class anyway (as -Equals- / -GetHashCode-), so that would take precedence over a default interface method).0x000D0x000A0x000D0x000ANote that although this interface does not specify any maximum length of the string representation of the key (especially -IKString-) keys should be kept reasonable short in order to be practical in URL's and as file and folder names when storing on disk.0x000D0x000ASee -IKCoded- which specifies a maximum of 250 characters in an encoded string representation of a key.
__TOCDet/Attribute/SubTypes = NewKey0x003BNewKeyCountP0x003BNewKeyCountPRec0x003BNewKeyGetType0x003BNewKeyToPropertyStream

Edit single sub keys only: __TOCDet

Generated 2025-04-16 09:35:02.173 UTC