Caller info attributes

C# language feature:

Caller info attributes

applies to

methods

benefit

Use Caller Info attributes to obtain information about the caller to a method i.e. member name, source code line number and file path of the caller. This information can be used for tracing, debugging, and creating diagnostic tools.

how to use

Apply the attribute System.Runtime.CompilerServices.? to optional parameters for a method. See example below.

example:

        public void DoProcessing()
        {
            TraceMessage("Something happened.");
        }

        public void TraceMessage(string message,
                [System.Runtime.CompilerServices.CallerMemberName] string memberName = "",
                [System.Runtime.CompilerServices.CallerFilePath] string sourceFilePath = "",
                [System.Runtime.CompilerServices.CallerLineNumber] int sourceLineNumber = 0)
        {
            System.Console.WriteLine("message: " + message);
            System.Console.WriteLine("member name: " + memberName);
            System.Console.WriteLine("source file path: " + sourceFilePath);
            System.Console.WriteLine("source line number: " + sourceLineNumber);
        }

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 *

Code-Sage