Code-Sage

C# language feature:

  • nameof operator

applies to

  • variable names in code

benefit

  • Improves coding maintainance. Avoids hard coding of a variable name in error messages, logs, etc. i.e. facilitates refactoring/renaming variables.

how to use

  • Replace string literal reference to variable with nameof(variable).

example:

        public string sirName;  // if this variable name is refactored/renamed the exception below will accurately reflect the renaming/refactored variable name
        public string LastName
        {
            get { return sirName; }
            set
            {
                if (value != sirName)
                {
                    throw new ArgumentException(message: "Name Changed", paramName: nameof(sirName));

                    // previously the following would cause confusion after a rename/refactoring of sirName.
                    throw new ArgumentException(message: "Name Changed", paramName: "sirName");
                }
            }
        }
C# articles

csharp v2 +

Anonymous methods * Co- and Contra-variance for delegates * Delegate inference * Generics * Getter and setter separate accessibility * Iterators * Method group conversions (delegates) * Nullable types * Partials * Static classes *

csharp v3 +

Anonymous types * Auto-Implemented properties * Expression trees * Extension methods * Implicitly typed local variables * Lambda expression * Object and collection initializers * Partial methods * Query expressions *

csharp v4 +

Generic co- and contravariance * Named and optional arguments *

csharp v5 +

Asynchronous methods * Caller info attributes *

csharp v6 +

A note for CSharp 6 and beyond * Allow await in catch and finally blocks * Auto property initializers * Default values for Read-only Auto-properties * Dictionary (index) initializers * Exception filters * Expression-bodied members * Import of static type members into namespace * Null propagator (null-conditional operator, succinct null checking) * String interpolation * nameof operator *

csharp v7 +

Binary literals * Deconstruction * Digit separators * Expression bodied constructors and finalizers * Expression bodied getters and setters * Generalized async return types * Local functions * Out variables * Pattern matching * Ref returns and locals * Tuples *