JJ.Framework.Common.Core 4.9.7151

JJ.Framework.Common.Core

General-purpose utilities with minimal dependencies.
An extension to JJ.Framework.Common.Legacy.

• NameHelper

  • Name() returns the current method name or current property name.
  • TextOf(...) gets the string representation of an expression.

• Flagging

  • Sets or gets flags from bit fields (ints) and flag enums.
    These otherwise require (hard to remember) bit operations.
    These can help you in a moment of confusion:

  • HasFlag to ask: "Is this bit or flag set?"

  • SetFlag / ClearFlag toggles a single flag

  • SetFlags / ClearFlags when you've got a collection of flags

• EnvironmentHelper

  • EnvironmentVariableIsDefined method: shorthand to check if an environment variable is defined with a specific key and value.

• ConfigurationHelperCore

  • TryGetSection method that complements GetSection but now when the configuration section is not found, null is returned, instead of a crash. (This helper avoids direct use of System.Configuration.)

• OverloadByName / NameOvl

  • Allows overloading by parameter name, which you normally cannot do:

    MyMethod(10, arg: true);
    MyMethod(10, differentArg: true);
    

  • One of those methods has a hidden optional parameter:

    void MyMethod(int num, bool arg);
    void MyMethod(int num, bool differentArg, OverloadByName ovl = default);
    

• GenericOverload / GenOvl:

  • Dummy type used to differentiate generic method overloads that only differ by generic constraints e.g.,

    where T : struct
    where T : class
    

  • C# does not always allow overloading based solely on generic constraints, so this marker type enables the the use of such overloads anyway, by showing distinct signatures to the compiler e.g.,

    MyMethod() where T : struct
    MyMethod(GenOvl _ = default) where T : class
    

  • The the calls to the generic overloads will differentiate just fine and do not require active use of the optional parameter.

  • (When brevity is required GenOvl can serve as a synonym for GenericOverload.)

Release Notes

2026-02-17 | 3.7 : Clash of the Booleans

• OverloadByName helper for an optional parameter trick to simulate overloading by name, not normally possible in C#.

2026-06-29 | 4.8 : Small Addition

• GenericOverload / GenOvl:
• Placeholder type for adding optional parameters to generic overloads, that would otherwise clash.
• This type adds docs explaning the technique, and avoids further overload clashes, from chosing a different parameter type.

💬 Feedback

Found an issue? Let me know.