Local Constant

Documentation Index

Fetch the complete documentation index at: https://docs.syntblaze.com/llms.txt

Use this file to discover all available pages before exploring further.

const [data_type] [identifier] = [compile_time_expression];

​

Technical Characteristics

• Compile-Time Evaluation: The expression assigned to a local constant must be resolvable entirely by the compiler. It cannot depend on runtime evaluations, method invocations, or the state of other non-constant variables.
• Mandatory Initialization: A local constant must be initialized at the exact point of declaration. It cannot be declared uninitialized and assigned a value later in the execution flow.
• Type Restrictions: Allowed constant types are strictly limited to simple types (e.g., int, double, char, bool, decimal), string, enum types, and reference types (provided the reference type is assigned a literal value of null).
• Lexical Scoping and Shadowing: The identifier is bound strictly to the enclosing block { ... } and is inaccessible outside this specific lexical environment. If a local constant shares an identifier with a class-level field, the local constant shadows (hides) the class-level field within that local scope. However, declaring a local constant with the same name as a local variable in an enclosing block is not permitted and will result in a compile-time error (CS0136).
• Explicit Typing: The var keyword cannot be used in conjunction with const. The data type must be explicitly declared.
• IL Embedding: Local constants do not occupy stack memory at runtime in the same way standard local variables do. The C# compiler evaluates the constant and embeds its literal value directly into the Intermediate Language (IL) instructions wherever the identifier is referenced.

​

Syntax Visualization

public class DataProcessor
{
    private int _threshold = 50; // Class-level field

    public void ProcessData()
    {
        // Valid local constants
        const double Pi = 3.14159;
        const int BaseMultiplier = 10;
        const string Prefix = "Data_";
        const DayOfWeek StartDay = DayOfWeek.Monday; // Enum type
        
        // Valid: Compile-time expression using other constants
        const int MaxValue = BaseMultiplier * 5; 
        
        // Valid: Reference type assigned to null
        const object EmptyReference = null;

        // Valid: Shadows the class-level '_threshold' field within this method
        const int _threshold = 100; 

        // INVALID: Cannot use implicit typing ('var')
        // const var InvalidConst = 5; 
        
        // INVALID: Cannot assign a runtime-evaluated value
        // const DateTime CurrentTime = DateTime.Now; 
        
        // INVALID: Cannot reassign after initialization
        // Pi = 3.14; 
    }

    public void EvaluateScope()
    {
        int index = 0; // Enclosing local variable

        if (true)
        {
            // INVALID: Compile-time error (CS0136). 
            // Cannot declare a local constant with the same name as a local variable in an enclosing scope.
            // const int index = 1; 
        }
    }
}