C# Field Keyword — Complete Guide

In this tutorial, you'll learn about C# Field Keyword. We cover key concepts, practical examples, and best practices.

You need a property with logic in the getter or setter, so you declare a private backing field and write the property body. That is six lines for a simple validation. The field keyword (C# 13 preview) lets you access the auto-generated backing field directly.

Wrong

private string _name;
public string Name
{
    get => _name;
    set => _name = value ?? throw new ArgumentNullException(nameof(Name));
}

Output: Works. Twelve lines for one property (field + property declaration).

Right

public string Name
{
    get => field;
    set => field = value ?? throw new ArgumentNullException(nameof(Name));
}

Output: Same behavior. No explicit backing field. The field keyword refers to the compiler-generated backing field.

The field keyword works in property accessors, indexers, and event accessors. It is only valid inside the accessor body of an auto-property or expression-bodied property.

private int _age;
public int Age
{
    get => _age;
    set => _age = value < 0 ? 0 : value;
}
// Becomes:
public int Age
{
    get => field;
    set => field = value < 0 ? 0 : value;
}

Prevention

• Use field to avoid declaring explicit backing fields for simple validation or transformation.
• Use field in init-only setters for initialization-time logic.
• Use field with INotifyPropertyChanged to reduce boilerplate.
• Fall back to explicit fields when you need ref return, volatile, or attributes on the field.
• Keep the backing field implicit unless you need specific field-level attributes.

Common Mistakes with field keyword

1. Forgetting that lazy evaluation defers computation until the value is forced, causing space leaks with unevaluated thunks
2. Using return to exit a function early instead of wrapping a pure value in the monad
3. Mixing let bindings with <- bindings in do notation, producing type errors

These mistakes appear frequently in real-world CSHARP code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ

The field keyword reduces boilerplate in DodaTech's data models. For more C# features, visit DodaTech.