feat(csharp): adds a missed first or default opprtunity rule

[baywet]

there are already rules for missed where/all/oftype/select/cast opportunities. It only makes sense to have FirstOrDefault which is a very common use case. Related #22484

[Copilot]

🟡 Changes recommended

The detection currently produces behavior-changing recommendations for converted iteration types, incompatible defaults, and asynchronous enumeration.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Adds a C# quality query detecting loops that can use LINQ’s FirstOrDefault.

Changes:

• Implements and registers the new query.
• Adds documentation, examples, and tests.
• Extends shared LINQ detection helpers.

File summaries

File	Description
csharp/ql/lib/Linq/Helpers.qll	Adds detection logic.
csharp/ql/src/Linq/MissedFirstOrDefaultOpportunity.ql	Defines the query.
csharp/ql/src/Linq/MissedFirstOrDefaultOpportunity.qhelp	Documents the recommendation.
csharp/ql/src/Linq/MissedFirstOrDefaultOpportunity.cs	Provides a flagged example.
csharp/ql/src/Linq/MissedFirstOrDefaultOpportunityFix.cs	Provides the recommended fix.
csharp/ql/src/Linq/MissedFirstOrDefaultOpportunityGood.cs	Provides non-alerting examples.
csharp/ql/src/codeql-suites/csharp-security-and-quality.qls	Enables the query in the quality suite.
csharp/ql/test/query-tests/Linq/MissedFirstOrDefaultOpportunity/MissedFirstOrDefaultOpportunity.cs	Adds test cases.
csharp/ql/test/query-tests/Linq/MissedFirstOrDefaultOpportunity/MissedFirstOrDefaultOpportunity.qlref	Configures the query test.
csharp/ql/test/query-tests/Linq/MissedFirstOrDefaultOpportunity/MissedFirstOrDefaultOpportunity.expected	Records expected results.

Review details

Suppressed comments (2)

csharp/ql/lib/Linq/Helpers.qll:184

• This only checks that the condition accesses the iteration variable, but foreach may implicitly convert each source element to a different variable type. For example, foreach (string value in IEnumerable<object>) can match here, while FirstOrDefault receives and returns object, so the proposed replacement neither exposes string members in the predicate nor returns the same type. Require an identity conversion between fes.getElementType() and the iteration-variable type (or account for the required Cast<T>()).

  exists(VariableAccess va |
    va.getTarget() = fes.getVariable() and
    va = is.getCondition().getAChildExpr*()

csharp/ql/lib/Linq/Helpers.qll:179

• Exclude asynchronous foreach statements here. A type can implement both IAsyncEnumerable<T> and IEnumerable<T>, so it satisfies ForeachStmtGenericEnumerable, but replacing its await foreach with FirstOrDefault switches to synchronous enumeration and can change behavior.

  is = firstStmt(fes) and

• Files reviewed: 10/10 changed files
• Comments generated: 1
• Review effort level: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.