/ doc / toc / ARCCore / Class / PValue<T>

PValue<T>

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 = Single value storage.0x000D0x000A0x000D0x000AUsed for storing single property values (without metadata), like customer's 'FirstName' and 'LastName'.0x000D0x000A0x000D0x000AThe most memory-efficient 'property'-object to use, when only the actual value of a property is needed.0x000D0x000A(unable to store any sub-properties or metadata).0x000D0x000ABut see also -PExact- which stores values directly, and uses this class -PValue- only for packing and unpacking the values.0x000D0x000A0x000D0x000AImmutable (assuming generic type is also immutable).0x000D0x000A0x000D0x000ATypically used for storing properties like 'Customer.FirstName', 'Product.Price' and so on.0x000D0x000A0x000D0x000AThis class supports duck-typing, especially in -TryGetV- which can return a basic value type like int, long, double, DateTime, TimeSpan, enum based on a string value, or even convert between values, like returning a double if the original -Value- is an int and so on.0x000D0x000AIt is still however recommended to have a strongly typed schema, that is, using -PKTypeAttribute- in order to specify the original type of a value.0x000D0x000ASee also -ConvertObjectToString-.0x000D0x000A0x000D0x000AWhen storing of metadata is desired, a more complicated approach is used. See -Value- for a more detailed explanation about this0x000D0x000AUsing this class should give an overhead per object of 24 bytes (16 for object header, 8 for -Value-), in addition to the space needed for the actual object (of type T) stored. Note, when calculating space needed for the actual object (of type T) you must remember to include boxing-overhead for value types.0x000D0x000ASee also -MemoryConsumption-.0x000D0x000A0x000D0x000ATODO: Consider creating a PValueVal-class for storing value types. This should get rid of boxing...?0x000D0x000ATODO: (However, no practical use-case has been seen as of Jul 2020 because of -PExact- TODO: which stores objects directly within an Object0x005B0x005D, that is, not using -PValue- at all.)0x000D0x000A0x000D0x000ASee also -MemoryConsumption-.
__TOCDet/DocFragType = Class
__TOCDet/Name = PValue0x003CT0x003E
__TOCDet/Namespace = ARCCore
__TOCDet/Type = PValue0x003CT0x003E
__TOCDet/Attribute/AssemblyName = ARCCore
__TOCDet/Attribute/ClassNamespace = ARCCore
__TOCDet/Attribute/ClassType = PValue0x003CT0x003E
__TOCDet/Attribute/Description = Single value storage.0x000D0x000A0x000D0x000AUsed for storing single property values (without metadata), like customer's 'FirstName' and 'LastName'.0x000D0x000A0x000D0x000AThe most memory-efficient 'property'-object to use, when only the actual value of a property is needed.0x000D0x000A(unable to store any sub-properties or metadata).0x000D0x000ABut see also -PExact- which stores values directly, and uses this class -PValue- only for packing and unpacking the values.0x000D0x000A0x000D0x000AImmutable (assuming generic type is also immutable).0x000D0x000A0x000D0x000ATypically used for storing properties like 'Customer.FirstName', 'Product.Price' and so on.0x000D0x000A0x000D0x000AThis class supports duck-typing, especially in -TryGetV- which can return a basic value type like int, long, double, DateTime, TimeSpan, enum based on a string value, or even convert between values, like returning a double if the original -Value- is an int and so on.0x000D0x000AIt is still however recommended to have a strongly typed schema, that is, using -PKTypeAttribute- in order to specify the original type of a value.0x000D0x000ASee also -ConvertObjectToString-.0x000D0x000A0x000D0x000AWhen storing of metadata is desired, a more complicated approach is used. See -Value- for a more detailed explanation about this0x000D0x000AUsing this class should give an overhead per object of 24 bytes (16 for object header, 8 for -Value-), in addition to the space needed for the actual object (of type T) stored. Note, when calculating space needed for the actual object (of type T) you must remember to include boxing-overhead for value types.0x000D0x000ASee also -MemoryConsumption-.0x000D0x000A0x000D0x000ATODO: Consider creating a PValueVal-class for storing value types. This should get rid of boxing...?0x000D0x000ATODO: (However, no practical use-case has been seen as of Jul 2020 because of -PExact- TODO: which stores objects directly within an Object0x005B0x005D, that is, not using -PValue- at all.)0x000D0x000A0x000D0x000ASee also -MemoryConsumption-.
__TOCDet/Attribute/Interfaces = IEquatable0xoooo003CPValue0xoooo003CT0xoooo003E0xoooo003E0x003BIP0x003BIEnumerable0xoooo003CIKIP0xoooo003E0x003BIEnumerable
__TOCDet/Attribute/InterfacesDirectlyImplemented = IEquatable0xoooo003CPValue0xoooo003CT0xoooo003E0xoooo003E0x003BIP0x003BIEnumerable0xoooo003CIKIP0xoooo003E0x003BIEnumerable
.ctor/__TOCDet/Assembly = ARCCore
.ctor/__TOCDet/Description = Note how this class does not have a parameter-less constructor (unlike all other -IP--derived classes in AgoRapide)
.ctor/__TOCDet/DocFragType = ClassMember
.ctor/__TOCDet/IsInherited = False
.ctor/__TOCDet/IsInheritedDoc = False
.ctor/__TOCDet/Lines = 1
.ctor/__TOCDet/Name = .ctor
.ctor/__TOCDet/Namespace = ARCCore
.ctor/__TOCDet/Type = PValue0x003CT0x003E
.ctor/__TOCDet/Attribute/DeclaringType = PValue0x003CT0x003E
.ctor/__TOCDet/Attribute/Description = Note how this class does not have a parameter-less constructor (unlike all other -IP--derived classes in AgoRapide)
.ctor/__TOCDet/Attribute/MethodName = .ctor
.ctor/__TOCDet/Attribute/MethodSignature = Void .ctor(T)
ConvertObjectToString/__TOCDet/Assembly = ARCCore
ConvertObjectToString/__TOCDet/Description = Converts object to string.0x000D0x000A0x000D0x000AUses decimal digits for double with full stop as decimal point, like '1.23'.0x000D0x000AUses -ToStringDateAndTime- for DateTime objects (but 'yyyy-MM-dd' if no time-of-day is 00:00:00.000').0x000D0x000AUses -ToStringWithMS- for DateTime objects.0x000D0x000AUses -ToStringShort- for Type objects.0x000D0x000AFor other object types the general ToString method is used.0x000D0x000A0x000D0x000ANote: See also the concept of -FunctionKey- in -ARCQuery- which can also be used for formatting objects.0x000D0x000A0x000D0x000ATODO: Add more object types here (or (even better) find a more generic approach to the general issue of converting objects to string in AgoRapide)0x000D0x000ATODO: AND / OR, Implement some kind of format-description in PK in order to decide string-format0x000D0x000ATOOD: (the last idea would require PK as a key here).0x000D0x000A0x000D0x000ATODO: Move this method out of this generic class (PValue0x003CT0x003E), calling it requires a genetic type parameter now.
ConvertObjectToString/__TOCDet/DocFragType = ClassMember
ConvertObjectToString/__TOCDet/IsInherited = False
ConvertObjectToString/__TOCDet/IsInheritedDoc = False
ConvertObjectToString/__TOCDet/Lines = 15
ConvertObjectToString/__TOCDet/Name = ConvertObjectToString
ConvertObjectToString/__TOCDet/Namespace = ARCCore
ConvertObjectToString/__TOCDet/Type = PValue0x003CT0x003E
ConvertObjectToString/__TOCDet/Attribute/DeclaringType = PValue0x003CT0x003E
ConvertObjectToString/__TOCDet/Attribute/Description = Converts object to string.0x000D0x000A0x000D0x000AUses decimal digits for double with full stop as decimal point, like '1.23'.0x000D0x000AUses -ToStringDateAndTime- for DateTime objects (but 'yyyy-MM-dd' if no time-of-day is 00:00:00.000').0x000D0x000AUses -ToStringWithMS- for DateTime objects.0x000D0x000AUses -ToStringShort- for Type objects.0x000D0x000AFor other object types the general ToString method is used.0x000D0x000A0x000D0x000ANote: See also the concept of -FunctionKey- in -ARCQuery- which can also be used for formatting objects.0x000D0x000A0x000D0x000ATODO: Add more object types here (or (even better) find a more generic approach to the general issue of converting objects to string in AgoRapide)0x000D0x000ATODO: AND / OR, Implement some kind of format-description in PK in order to decide string-format0x000D0x000ATOOD: (the last idea would require PK as a key here).0x000D0x000A0x000D0x000ATODO: Move this method out of this generic class (PValue0x003CT0x003E), calling it requires a genetic type parameter now.
ConvertObjectToString/__TOCDet/Attribute/MethodName = ConvertObjectToString
ConvertObjectToString/__TOCDet/Attribute/MethodSignature = System.String ConvertObjectToString(System.Object)
DeepCopy/__TOCDet/Assembly = ARCCore
DeepCopy/__TOCDet/Description = Note that if the generic type (T) is not immutable, then what we return will not be a truly deep copy.0x000D0x000A0x000D0x000AThis is also noted as a general limitation in the documentation for -DeepCopy-.0x000D0x000A
DeepCopy/__TOCDet/DocFragType = ClassMember
DeepCopy/__TOCDet/IsInherited = False
DeepCopy/__TOCDet/IsInheritedDoc = False
DeepCopy/__TOCDet/Lines = 4
DeepCopy/__TOCDet/Name = DeepCopy
DeepCopy/__TOCDet/Namespace = ARCCore
DeepCopy/__TOCDet/Type = PValue0x003CT0x003E
DeepCopy/__TOCDet/Attribute/DeclaringType = PValue0x003CT0x003E
DeepCopy/__TOCDet/Attribute/Description = Note that if the generic type (T) is not immutable, then what we return will not be a truly deep copy.0x000D0x000A0x000D0x000AThis is also noted as a general limitation in the documentation for -DeepCopy-.0x000D0x000A
DeepCopy/__TOCDet/Attribute/MethodName = DeepCopy
DeepCopy/__TOCDet/Attribute/MethodSignature = ARCCore.IP DeepCopy()
ToString/__TOCDet/Assembly = ARCCore
ToString/__TOCDet/Description = Do no cache this value, because memory consumption would then increase significantly in your applicationj
ToString/__TOCDet/DocFragType = ClassMember
ToString/__TOCDet/IsInherited = False
ToString/__TOCDet/IsInheritedDoc = False
ToString/__TOCDet/Lines = 1
ToString/__TOCDet/Name = ToString
ToString/__TOCDet/Namespace = ARCCore
ToString/__TOCDet/Type = PValue0x003CT0x003E
ToString/__TOCDet/Attribute/DeclaringType = PValue0x003CT0x003E
ToString/__TOCDet/Attribute/Description = Do no cache this value, because memory consumption would then increase significantly in your applicationj
ToString/__TOCDet/Attribute/MethodName = ToString
ToString/__TOCDet/Attribute/MethodSignature = System.String ToString()
TryGetV/__TOCDet/Assembly = ARCCore
TryGetV/__TOCDet/Description = Supports duck typing.0x000D0x000A0x000D0x000AAttempts to convert value as far as possible, including casting double to int or long, upgrading int or long to double, or int to long, and converting string to int, long, double, DateTime, TimeSpan and enum.0x000D0x000A0x000D0x000ASee also -ConvertObjectToString-.0x000D0x000A0x000D0x000ATODO: Make also able to convert string to -ITypeDescriber-. (if ITypeDescriber.IsAssignableFrom(TRequest))
TryGetV/__TOCDet/DocFragType = ClassMember
TryGetV/__TOCDet/IsInherited = False
TryGetV/__TOCDet/IsInheritedDoc = False
TryGetV/__TOCDet/Lines = 7
TryGetV/__TOCDet/Name = TryGetV
TryGetV/__TOCDet/Namespace = ARCCore
TryGetV/__TOCDet/Type = PValue0x003CT0x003E
TryGetV/__TOCDet/Attribute/DeclaringType = PValue0x003CT0x003E
TryGetV/__TOCDet/Attribute/Description = Supports duck typing.0x000D0x000A0x000D0x000AAttempts to convert value as far as possible, including casting double to int or long, upgrading int or long to double, or int to long, and converting string to int, long, double, DateTime, TimeSpan and enum.0x000D0x000A0x000D0x000ASee also -ConvertObjectToString-.0x000D0x000A0x000D0x000ATODO: Make also able to convert string to -ITypeDescriber-. (if ITypeDescriber.IsAssignableFrom(TRequest))
TryGetV/__TOCDet/Attribute/MethodName = TryGetV
TryGetV/__TOCDet/Attribute/MethodSignature = Boolean TryGetV0x005BTRequest0x005D(TRequest ByRef, System.String ByRef)
TrySetP/__TOCDet/Assembly = ARCCore
TrySetP/__TOCDet/Description = NOTE: -TryStore- is explicit aware that -PValue- and -PValueEmpty-0x000D0x000ANOTE: are not able to do -TrySetP-, and will replace these with -PRich- instead as needed.0x000D0x000ANOTE: See -Value- for more information.
TrySetP/__TOCDet/DocFragType = ClassMember
TrySetP/__TOCDet/IsInherited = False
TrySetP/__TOCDet/IsInheritedDoc = False
TrySetP/__TOCDet/Lines = 3
TrySetP/__TOCDet/Name = TrySetP
TrySetP/__TOCDet/Namespace = ARCCore
TrySetP/__TOCDet/Type = PValue0x003CT0x003E
TrySetP/__TOCDet/Attribute/DeclaringType = PValue0x003CT0x003E
TrySetP/__TOCDet/Attribute/Description = NOTE: -TryStore- is explicit aware that -PValue- and -PValueEmpty-0x000D0x000ANOTE: are not able to do -TrySetP-, and will replace these with -PRich- instead as needed.0x000D0x000ANOTE: See -Value- for more information.
TrySetP/__TOCDet/Attribute/MethodName = TrySetP
TrySetP/__TOCDet/Attribute/MethodSignature = Boolean TrySetP(ARCCore.IKIP, System.String ByRef)

Edit single sub keys only: __TOCDet / .ctor / ConvertObjectToString / DeepCopy / ToString / TryGetV / TrySetP

Generated 2025-06-19 15:57:51.099 UTC