/ doc / tocInheritance / ITypeDescriber / __TOCDet / Attribute / LongDescription

LongDescription

Edit keys at this level only

= See also -IP- which describes multiple value properties (that is, 'entities' like Customer, Product, Order). 0x000D0x000ANote that the use of a static method is a practical choice since it avoids AgoRapide having to instantiate the class for what is essential a static one-off operation done only once (for instance at application initialization, or on-demand).0x000D0x000AThis however means that the compiler is unable to check if your class really implements 'EnrichKey' as 'promised' by the fact of it being marked as implementing this interface. Missing implementations will show up at runtime with a helpful and explanatory error messages.0x000D0x000A0x000D0x000ANote that for some attributes you actually have a choice of where to specify them.0x000D0x000A(example below assumes a PKDataAttribute-class with a property called 'InvalidValueExample')0x000D0x000ATODO: FIND ETTER EXAMPLES WHEN SOME REAL BasePKAttribute subclasses are defined in AgoRapide0x000D0x000A0x000D0x000AYou can specify either by0x000D0x000A0x000D0x000A1) Tagging directly the corresponding 'enum' field (enums of type -PropertyKeyEnum-) with some -PKTypeAttribute- like:0x000D0x000A0x000D0x000Aenum CustomerP 0x007B0x000D0x000A  ...0x000D0x000A  0x005BPKType(Type=DateOfBirth)0x005D0x000D0x000A  0x005BPKData(InvalidValueExample = "1968-13-09")0x005D0x000D0x000A  DateOfBirth,0x000D0x000A  ...0x000D0x000A0x007D0x000D0x000A0x000D0x000A(but then you will have to do that everywhere you are using the implementing class (in this example the type 'DateOfBirth') because there will be a separate -PK- generated for each 'enum' field).  0x000D0x000Aor 0x000D0x000A2) by setting them when the resulting -PK- is passed to EnrichKey (from wherever 'DateOfBirth' is used) like (note, code is somewhat simplified):0x000D0x000A0x000D0x000A   public class DateOfBirth : ITypeDescriber 0x007B0x000D0x000A      ...0x000D0x000A      public static void EnrichKey(PK k) 0x007B0x000D0x000A          var pkData = new PKDataAttribute()0x003B0x000D0x000A          pkData.AddPV(PKDataAttributeP.InvalidValueExample.A(), "1968-13-09")0x003B0x000D0x000A          k.AddP(IKType.FromType(pkData.GetType()), pkData)0x003B0x000D0x000A      0x007D)0x003B0x000D0x000A   0x007D0x000D0x000A0x000D0x000AThe latter method is supposedly better.0x000D0x000A0x000D0x000ANote that attributes like -ValidatorAndParser- can only be set through EnrichKey because they are too complex for the -Attribute- mechanism

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

Generated 2025-07-29 02:43:24.169 UTC