/ doc / toc / ARCCore / Class / Extensions

Extensions

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 = Contains a few general nice to have extensions methods.0x000D0x000A0x000D0x000ATODO: If this class accumulates too many methods, consider splitting it into multiple classes in a separate folder.0x000D0x000ATODO: For instance a TypeExtensions class and DictionaryExtensions class would be natural.0x000D0x000ATODO: (together with maybe a StringExtensionClass).0x000D0x000A0x000D0x000ANOTE: Message to developers. Think through before you decide on adding anything to this class. It should really be kept as small as possible.0x000D0x000ANOTE: Often a utility method in a related class is good enough.0x000D0x000A0x000D0x000ASee also -UtilCore-.
__TOCDet/DocFragType = Class
__TOCDet/Name = Extensions
__TOCDet/Namespace = ARCCore
__TOCDet/Type = Extensions
__TOCDet/Attribute/AssemblyName = ARCCore
__TOCDet/Attribute/ClassNamespace = ARCCore
__TOCDet/Attribute/ClassType = Extensions
__TOCDet/Attribute/Description = Contains a few general nice to have extensions methods.0x000D0x000A0x000D0x000ATODO: If this class accumulates too many methods, consider splitting it into multiple classes in a separate folder.0x000D0x000ATODO: For instance a TypeExtensions class and DictionaryExtensions class would be natural.0x000D0x000ATODO: (together with maybe a StringExtensionClass).0x000D0x000A0x000D0x000ANOTE: Message to developers. Think through before you decide on adding anything to this class. It should really be kept as small as possible.0x000D0x000ANOTE: Often a utility method in a related class is good enough.0x000D0x000A0x000D0x000ASee also -UtilCore-.
AddValue/__TOCDet/Assembly = ARCCore
AddValue/__TOCDet/Description = Gives better error messages compared to 'original' Add when adding a value to a directory if key already exists
AddValue/__TOCDet/DocFragType = ClassMember
AddValue/__TOCDet/IsInherited = False
AddValue/__TOCDet/IsInheritedDoc = False
AddValue/__TOCDet/Lines = 1
AddValue/__TOCDet/Name = AddValue
AddValue/__TOCDet/Namespace = ARCCore
AddValue/__TOCDet/Type = Extensions
AddValue/__TOCDet/Attribute/DeclaringType = Extensions
AddValue/__TOCDet/Attribute/Description = Gives better error messages compared to 'original' Add when adding a value to a directory if key already exists
AddValue/__TOCDet/Attribute/MethodName = AddValue
AddValue/__TOCDet/Attribute/MethodSignature = Void AddValue0x005BTKey,TValue0x005D(System.Collections.Generic.Dictionary0x006020x005BTKey,TValue0x005D, TKey, TValue, System.Func0x006010x005BSystem.String0x005D)
ForEach/__TOCDet/Assembly = ARCCore
ForEach/__TOCDet/Description = Useful when we want to write collection.ForEach( ... ) instead of 0x000D0x000Acollection.ToList().ForEach ( ... )    (Bad idea performance-wise) 0x000D0x000Aor0x000D0x000Aforeach (var t in collection)   which is more verbose 0x000D0x000A0x000D0x000ADiscussion about this at0x000D0x000Ahttp://blogs.msdn.com/b/ericlippert/archive/2009/05/18/foreach-vs-foreach.aspx0x000D0x000A(short version http://stackoverflow.com/questions/10299458/is-the-listt-foreach-method-gone0x000D0x000A
ForEach/__TOCDet/DocFragType = ClassMember
ForEach/__TOCDet/IsInherited = False
ForEach/__TOCDet/IsInheritedDoc = False
ForEach/__TOCDet/Lines = 9
ForEach/__TOCDet/Name = ForEach
ForEach/__TOCDet/Namespace = ARCCore
ForEach/__TOCDet/Type = Extensions
ForEach/__TOCDet/Attribute/DeclaringType = Extensions
ForEach/__TOCDet/Attribute/Description = Useful when we want to write collection.ForEach( ... ) instead of 0x000D0x000Acollection.ToList().ForEach ( ... )    (Bad idea performance-wise) 0x000D0x000Aor0x000D0x000Aforeach (var t in collection)   which is more verbose 0x000D0x000A0x000D0x000ADiscussion about this at0x000D0x000Ahttp://blogs.msdn.com/b/ericlippert/archive/2009/05/18/foreach-vs-foreach.aspx0x000D0x000A(short version http://stackoverflow.com/questions/10299458/is-the-listt-foreach-method-gone0x000D0x000A
ForEach/__TOCDet/Attribute/MethodName = ForEach
ForEach/__TOCDet/Attribute/MethodSignature = Void ForEach0x005BT0x005D(System.Collections.Generic.IEnumerable0x006010x005BT0x005D, System.Action0x006010x005BT0x005D)
GetValue/__TOCDet/Assembly = ARCCore
GetValue/__TOCDet/Description = Gives better error messages when reading value from directory if key does not exist
GetValue/__TOCDet/DocFragType = ClassMember
GetValue/__TOCDet/IsInherited = False
GetValue/__TOCDet/IsInheritedDoc = False
GetValue/__TOCDet/Lines = 1
GetValue/__TOCDet/Name = GetValue
GetValue/__TOCDet/Namespace = ARCCore
GetValue/__TOCDet/Type = Extensions
GetValue/__TOCDet/Attribute/DeclaringType = Extensions
GetValue/__TOCDet/Attribute/Description = Gives better error messages when reading value from directory if key does not exist
GetValue/__TOCDet/Attribute/MethodName = GetValue
GetValue/__TOCDet/Attribute/MethodSignature = TValue GetValue0x005BTKey,TValue0x005D(System.Collections.Generic.Dictionary0x006020x005BTKey,TValue0x005D, TKey, System.Func0x006010x005BSystem.String0x005D)
KeysAsString/__TOCDet/Assembly = ARCCore
KeysAsString/__TOCDet/Description = Gives a compressed overview of keys in a dictionary. Helpful for building exception messages.
KeysAsString/__TOCDet/DocFragType = ClassMember
KeysAsString/__TOCDet/IsInherited = False
KeysAsString/__TOCDet/IsInheritedDoc = False
KeysAsString/__TOCDet/Lines = 1
KeysAsString/__TOCDet/Name = KeysAsString
KeysAsString/__TOCDet/Namespace = ARCCore
KeysAsString/__TOCDet/Type = Extensions
KeysAsString/__TOCDet/Attribute/DeclaringType = Extensions
KeysAsString/__TOCDet/Attribute/Description = Gives a compressed overview of keys in a dictionary. Helpful for building exception messages.
KeysAsString/__TOCDet/Attribute/MethodName = KeysAsString
KeysAsString/__TOCDet/Attribute/MethodSignature = System.String KeysAsString0x005BTKey,TValue0x005D(System.Collections.Generic.Dictionary0x006020x005BTKey,TValue0x005D)
Result/__TOCDet/Assembly = ARCCore
Result/__TOCDet/Description = Returns heading plus return-value of function (calls function). If function == null then empty string is returned
Result/__TOCDet/DocFragType = ClassMember
Result/__TOCDet/IsInherited = False
Result/__TOCDet/IsInheritedDoc = False
Result/__TOCDet/Lines = 1
Result/__TOCDet/Name = Result
Result/__TOCDet/Namespace = ARCCore
Result/__TOCDet/Type = Extensions
Result/__TOCDet/Attribute/DeclaringType = Extensions
Result/__TOCDet/Attribute/Description = Returns heading plus return-value of function (calls function). If function == null then empty string is returned
Result/__TOCDet/Attribute/MethodName = Result
Result/__TOCDet/Attribute/MethodSignature = System.String Result(System.Func0x006010x005BSystem.String0x005D, System.String)
Single/__TOCDet/Assembly = ARCCore
Single/__TOCDet/Description = Same as inbuilt LINQ's Single except that gives a more friendly exception message
Single/__TOCDet/DocFragType = ClassMember
Single/__TOCDet/IsInherited = False
Single/__TOCDet/IsInheritedDoc = False
Single/__TOCDet/Lines = 1
Single/__TOCDet/Name = Single
Single/__TOCDet/Namespace = ARCCore
Single/__TOCDet/Type = Extensions
Single/__TOCDet/Attribute/DeclaringType = Extensions
Single/__TOCDet/Attribute/Description = Same as inbuilt LINQ's Single except that gives a more friendly exception message
Single/__TOCDet/Attribute/MethodName = Single
Single/__TOCDet/Attribute/MethodSignature = T Single0x005BT0x005D(System.Collections.Generic.IEnumerable0x006010x005BT0x005D, System.Func0x006020x005BT,System.Boolean0x005D, System.Func0x006010x005BSystem.String0x005D)
SingleOrDefault/__TOCDet/Assembly = ARCCore
SingleOrDefault/__TOCDet/Description = Same as inbuilt LINQ's SingleOrDefault except that gives a more friendly exception message
SingleOrDefault/__TOCDet/DocFragType = ClassMember
SingleOrDefault/__TOCDet/IsInherited = False
SingleOrDefault/__TOCDet/IsInheritedDoc = False
SingleOrDefault/__TOCDet/Lines = 1
SingleOrDefault/__TOCDet/Name = SingleOrDefault
SingleOrDefault/__TOCDet/Namespace = ARCCore
SingleOrDefault/__TOCDet/Type = Extensions
SingleOrDefault/__TOCDet/Attribute/DeclaringType = Extensions
SingleOrDefault/__TOCDet/Attribute/Description = Same as inbuilt LINQ's SingleOrDefault except that gives a more friendly exception message
SingleOrDefault/__TOCDet/Attribute/MethodName = SingleOrDefault
SingleOrDefault/__TOCDet/Attribute/MethodSignature = T SingleOrDefault0x005BT0x005D(System.Collections.Generic.IEnumerable0x006010x005BT0x005D, System.Func0x006020x005BT,System.Boolean0x005D, System.Func0x006010x005BSystem.String0x005D)
ToStringDateAndTime/__TOCDet/Assembly = ARCCore
ToStringDateAndTime/__TOCDet/Description = Uses format 'yyyy-MM-dd HH:mm:ss.fff'.0x000D0x000A0x000D0x000ASee also -DateTimeTryParse-.0x000D0x000A
ToStringDateAndTime/__TOCDet/DocFragType = ClassMember
ToStringDateAndTime/__TOCDet/IsInherited = False
ToStringDateAndTime/__TOCDet/IsInheritedDoc = False
ToStringDateAndTime/__TOCDet/Lines = 4
ToStringDateAndTime/__TOCDet/Name = ToStringDateAndTime
ToStringDateAndTime/__TOCDet/Namespace = ARCCore
ToStringDateAndTime/__TOCDet/Type = Extensions
ToStringDateAndTime/__TOCDet/Attribute/DeclaringType = Extensions
ToStringDateAndTime/__TOCDet/Attribute/Description = Uses format 'yyyy-MM-dd HH:mm:ss.fff'.0x000D0x000A0x000D0x000ASee also -DateTimeTryParse-.0x000D0x000A
ToStringDateAndTime/__TOCDet/Attribute/MethodName = ToStringDateAndTime
ToStringDateAndTime/__TOCDet/Attribute/MethodSignature = System.String ToStringDateAndTime(System.DateTime)
ToStringDB/__TOCDet/Assembly = ARCCore
ToStringDB/__TOCDet/Description = Gives the minimum representation of type as string suitable for later reconstruction by -GetType-.0x000D0x000A(that is with namespace and including all relevant assembly names but nothing more)0x000D0x000AThe returned string even takes into consideration generics when the generic type resides in a different assembly.0x000D0x000A0x000D0x000AThe return value is considered SQL-"safe" in the sense that it may be inserted directly into an SQL statement (not relevant for new AgoRapide (2020) though).0x000D0x000A0x000D0x000ACorresponding method for getting the type back is -TryGetTypeFromStringFromCache-.0x000D0x000A0x000D0x000ANote how caches result since operation is somewhat complicated due do generic types.0x000D0x000ANote how returns a string.Intern in order to make for quicker dictionary lookup as returned string will often be used for lookup in other caches.
ToStringDB/__TOCDet/DocFragType = ClassMember
ToStringDB/__TOCDet/IsInherited = False
ToStringDB/__TOCDet/IsInheritedDoc = False
ToStringDB/__TOCDet/Lines = 33
ToStringDB/__TOCDet/LongDescription = TODO: GIVE BETTER EXAMPLE below because ApplicationPart does not exist in new AgoRapide (2020).0x000D0x000A0x000D0x000AExample of return value is:0x000D0x000AApplicationPart0x003CP0x003E0x003B : AgoRapide.ApplicationPart0x006010x005BAgoRapideSample.P,AgoRapideSample0x005D,AgoRapide0x000D0x000A(the part before : is what is returned by -ToStringShort- and serves as a human readable shorthand)0x000D0x000A0x000D0x000ANote complexities involved around generic types where the generic argument exist in a different assembly.0x000D0x000AFor instance for:0x000D0x000A    typeof(AgoRapide.ApplicationPart0x007BAgoRapideSample.P0x007D)0x000D0x000A where ApplicationPart resides in AgoRapide and0x000D0x000A P resides in AgoRapideSample a simple approach like0x000D0x000A   -ToString- , -Assembly-.-GetName-0x000D0x000A would give0x000D0x000A   AgoRapide.ApplicationPart0x006010x005BAgoRapideSample.P0x005D,AgoRapide0x000D0x000A which is not enough information for -GetType-0x000D0x000A0x000D0x000A Therefore, for types where generic arguments exist in a different assembly we have to do like explained here:0x000D0x000A http://stackoverflow.com/questions/2276384/loading-a-generic-type-by-name-when-the-generics-arguments-come-from-multiple-as0x000D0x000A0x000D0x000A In our case what is returned by this methdod is something like mentioned above0x000D0x000A   AgoRapide.ApplicationPart0x006010x005BAgoRapideSample.P,AgoRapideSample0x005D,AgoRapide0x000D0x000A that is, we insert the assembly name where the type of the generic parameter resides, into the string.0x000D0x000A
ToStringDB/__TOCDet/Name = ToStringDB
ToStringDB/__TOCDet/Namespace = ARCCore
ToStringDB/__TOCDet/Type = Extensions
ToStringDB/__TOCDet/Attribute/DeclaringType = Extensions
ToStringDB/__TOCDet/Attribute/Description = Gives the minimum representation of type as string suitable for later reconstruction by -GetType-.0x000D0x000A(that is with namespace and including all relevant assembly names but nothing more)0x000D0x000AThe returned string even takes into consideration generics when the generic type resides in a different assembly.0x000D0x000A0x000D0x000AThe return value is considered SQL-"safe" in the sense that it may be inserted directly into an SQL statement (not relevant for new AgoRapide (2020) though).0x000D0x000A0x000D0x000ACorresponding method for getting the type back is -TryGetTypeFromStringFromCache-.0x000D0x000A0x000D0x000ANote how caches result since operation is somewhat complicated due do generic types.0x000D0x000ANote how returns a string.Intern in order to make for quicker dictionary lookup as returned string will often be used for lookup in other caches.
ToStringDB/__TOCDet/Attribute/LongDescription = TODO: GIVE BETTER EXAMPLE below because ApplicationPart does not exist in new AgoRapide (2020).0x000D0x000A0x000D0x000AExample of return value is:0x000D0x000AApplicationPart0x003CP0x003E0x003B : AgoRapide.ApplicationPart0x006010x005BAgoRapideSample.P,AgoRapideSample0x005D,AgoRapide0x000D0x000A(the part before : is what is returned by -ToStringShort- and serves as a human readable shorthand)0x000D0x000A0x000D0x000ANote complexities involved around generic types where the generic argument exist in a different assembly.0x000D0x000AFor instance for:0x000D0x000A    typeof(AgoRapide.ApplicationPart0x007BAgoRapideSample.P0x007D)0x000D0x000A where ApplicationPart resides in AgoRapide and0x000D0x000A P resides in AgoRapideSample a simple approach like0x000D0x000A   -ToString- , -Assembly-.-GetName-0x000D0x000A would give0x000D0x000A   AgoRapide.ApplicationPart0x006010x005BAgoRapideSample.P0x005D,AgoRapide0x000D0x000A which is not enough information for -GetType-0x000D0x000A0x000D0x000A Therefore, for types where generic arguments exist in a different assembly we have to do like explained here:0x000D0x000A http://stackoverflow.com/questions/2276384/loading-a-generic-type-by-name-when-the-generics-arguments-come-from-multiple-as0x000D0x000A0x000D0x000A In our case what is returned by this methdod is something like mentioned above0x000D0x000A   AgoRapide.ApplicationPart0x006010x005BAgoRapideSample.P,AgoRapideSample0x005D,AgoRapide0x000D0x000A that is, we insert the assembly name where the type of the generic parameter resides, into the string.0x000D0x000A
ToStringDB/__TOCDet/Attribute/MethodName = ToStringDB
ToStringDB/__TOCDet/Attribute/MethodSignature = System.String ToStringDB(System.Type)
ToStringShort/__TOCDet/Assembly = ARCCore
ToStringShort/__TOCDet/Description = Returns a shorter representation than -ToStringDB-.0x000D0x000A0x000D0x000ATODO: INSERT EXAMPLE OF WHAT IS MEANT BY 'SHORTER'.0x000D0x000A0x000D0x000ANote how the representation is easier to read for generic types, returning for instance List0x003Cstring0x003E instead of List0x006010x005Bstring0x005D.0x000D0x000A0x000D0x000ANote how caches result since operation is somewhat complicated due do generic types.0x000D0x000ANote how returns a string.Intern in order to make for quicker dictionary lookup as returned string will often be used for lookup in other caches.
ToStringShort/__TOCDet/DocFragType = ClassMember
ToStringShort/__TOCDet/IsInherited = False
ToStringShort/__TOCDet/IsInheritedDoc = False
ToStringShort/__TOCDet/Lines = 9
ToStringShort/__TOCDet/LongDescription = See also -ToStringDB- ('complete' representation) and -ToStringVeryShort- (shortest form)
ToStringShort/__TOCDet/Name = ToStringShort
ToStringShort/__TOCDet/Namespace = ARCCore
ToStringShort/__TOCDet/Type = Extensions
ToStringShort/__TOCDet/Attribute/DeclaringType = Extensions
ToStringShort/__TOCDet/Attribute/Description = Returns a shorter representation than -ToStringDB-.0x000D0x000A0x000D0x000ATODO: INSERT EXAMPLE OF WHAT IS MEANT BY 'SHORTER'.0x000D0x000A0x000D0x000ANote how the representation is easier to read for generic types, returning for instance List0x003Cstring0x003E instead of List0x006010x005Bstring0x005D.0x000D0x000A0x000D0x000ANote how caches result since operation is somewhat complicated due do generic types.0x000D0x000ANote how returns a string.Intern in order to make for quicker dictionary lookup as returned string will often be used for lookup in other caches.
ToStringShort/__TOCDet/Attribute/LongDescription = See also -ToStringDB- ('complete' representation) and -ToStringVeryShort- (shortest form)
ToStringShort/__TOCDet/Attribute/MethodName = ToStringShort
ToStringShort/__TOCDet/Attribute/MethodSignature = System.String ToStringShort(System.Type)
ToStringVeryShort/__TOCDet/Assembly = ARCCore
ToStringVeryShort/__TOCDet/Description = Returns same as -ToStringShort- but without any generics information at all.0x000D0x000A0x000D0x000AOne usage is to identify entity classes (like 'Customer', 'Order' and so on). We want those to be as simple as possible to refer to.0x000D0x000A0x000D0x000ANOTE: This method was probably created based on a misunderstanding about the fundamentals of generic classes.0x000D0x000ANOTE: There is probably really little or no use for it.0x000D0x000ANOTE: It is used throughout AgoRapide though.0x000D0x000A0x000D0x000ANote how caches result since operation is somewhat complicated due do generic types.0x000D0x000ANote how returns a string.Intern in order to make for quicker dictionary lookup as returned string will often be used for lookup in other caches.
ToStringVeryShort/__TOCDet/DocFragType = ClassMember
ToStringVeryShort/__TOCDet/IsInherited = False
ToStringVeryShort/__TOCDet/IsInheritedDoc = False
ToStringVeryShort/__TOCDet/Lines = 11
ToStringVeryShort/__TOCDet/LongDescription = See also -ToStringShort- (somewhat longer form) and -ToStringDB- ('complete' representation)
ToStringVeryShort/__TOCDet/Name = ToStringVeryShort
ToStringVeryShort/__TOCDet/Namespace = ARCCore
ToStringVeryShort/__TOCDet/Type = Extensions
ToStringVeryShort/__TOCDet/Attribute/DeclaringType = Extensions
ToStringVeryShort/__TOCDet/Attribute/Description = Returns same as -ToStringShort- but without any generics information at all.0x000D0x000A0x000D0x000AOne usage is to identify entity classes (like 'Customer', 'Order' and so on). We want those to be as simple as possible to refer to.0x000D0x000A0x000D0x000ANOTE: This method was probably created based on a misunderstanding about the fundamentals of generic classes.0x000D0x000ANOTE: There is probably really little or no use for it.0x000D0x000ANOTE: It is used throughout AgoRapide though.0x000D0x000A0x000D0x000ANote how caches result since operation is somewhat complicated due do generic types.0x000D0x000ANote how returns a string.Intern in order to make for quicker dictionary lookup as returned string will often be used for lookup in other caches.
ToStringVeryShort/__TOCDet/Attribute/LongDescription = See also -ToStringShort- (somewhat longer form) and -ToStringDB- ('complete' representation)
ToStringVeryShort/__TOCDet/Attribute/MethodName = ToStringVeryShort
ToStringVeryShort/__TOCDet/Attribute/MethodSignature = System.String ToStringVeryShort(System.Type)
ToStringWithMS/__TOCDet/Assembly = ARCCore
ToStringWithMS/__TOCDet/Description = Uses either format 'd\.hh\:mm\:ss\.fff' or 'hh\:mm\:ss\.fff' depending on TotalHours 0x003E=24 hours or not.0x000D0x000ASee also -TimeSpanTryParse-.0x000D0x000A
ToStringWithMS/__TOCDet/DocFragType = ClassMember
ToStringWithMS/__TOCDet/IsInherited = False
ToStringWithMS/__TOCDet/IsInheritedDoc = False
ToStringWithMS/__TOCDet/Lines = 3
ToStringWithMS/__TOCDet/Name = ToStringWithMS
ToStringWithMS/__TOCDet/Namespace = ARCCore
ToStringWithMS/__TOCDet/Type = Extensions
ToStringWithMS/__TOCDet/Attribute/DeclaringType = Extensions
ToStringWithMS/__TOCDet/Attribute/Description = Uses either format 'd\.hh\:mm\:ss\.fff' or 'hh\:mm\:ss\.fff' depending on TotalHours 0x003E=24 hours or not.0x000D0x000ASee also -TimeSpanTryParse-.0x000D0x000A
ToStringWithMS/__TOCDet/Attribute/MethodName = ToStringWithMS
ToStringWithMS/__TOCDet/Attribute/MethodSignature = System.String ToStringWithMS(System.TimeSpan)
Use/__TOCDet/Assembly = ARCCore
Use/__TOCDet/Description = Convenience method that shortens down code in cases where an instance of an object must be created first in order to use that same variable multiple times
Use/__TOCDet/DocFragType = ClassMember
Use/__TOCDet/IsInherited = False
Use/__TOCDet/IsInheritedDoc = False
Use/__TOCDet/Lines = 1
Use/__TOCDet/Name = Use
Use/__TOCDet/Namespace = ARCCore
Use/__TOCDet/Type = Extensions
Use/__TOCDet/Attribute/DeclaringType = Extensions
Use/__TOCDet/Attribute/Description = Convenience method that shortens down code in cases where an instance of an object must be created first in order to use that same variable multiple times
Use/__TOCDet/Attribute/MethodName = Use
Use/__TOCDet/Attribute/MethodSignature = Void Use0x005BT0x005D(T, System.Action0x006010x005BT0x005D)

Edit single sub keys only: __TOCDet / AddValue / ForEach / GetValue / KeysAsString / Result / Single / SingleOrDefault / ToStringDateAndTime / ToStringDB / ToStringShort / ToStringVeryShort / ToStringWithMS / Use

Generated 2025-05-23 21:00:11.889 UTC