Add explanation of why the when contextual keyword is better than if/else in catch blocks

[Copilot]

This PR addresses the lack of explanation for why C#'s when contextual keyword provides advantages over using if/else statements inside catch blocks. The key technical difference is that exception filters don't unwind the call stack, while traditional catch blocks do.

Changes Made

Enhanced exception-handling-statements.md

Added a comprehensive "Exception filters vs. traditional exception handling" section that explains:

• Exception filters (when) evaluate before stack unwinding, preserving the original call stack and local variables
• Traditional catch blocks unwind the stack before entering the handler, potentially losing debugging information
• Performance benefits when no filter matches (no unwinding overhead)
• Cleaner code organization for multiple conditions on the same exception type

Updated when.md

Added context explaining the advantages of exception filters with a cross-reference to the detailed explanation in the exception handling statements documentation.

New Code Examples

Created comprehensive working examples in WhenFilterExamples.cs demonstrating:

• Direct comparison between exception filters and if/else approaches
• Multiple condition handling scenarios
• Logging and diagnostic use cases that preserve debugging information

Technical Benefits Explained

The documentation now clearly explains why this approach is superior:

try
{
    ProcessFile();
}
catch (IOException ex) when (ex.Message.Contains("access denied"))
{
    // Filter evaluated before stack unwinding
    // Full debugging context still available
    HandleAccessDenied();
}
catch (IOException ex)
{
    // Traditional approach - stack already unwound
    if (ex.Message.Contains("not found"))
    {
        HandleNotFound();
    }
}

The exception filter approach is particularly valuable in production applications where preserving debugging information is crucial for diagnosing issues.

Fixes #40661.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

---

Internal previews

📄 File	🔗 Preview link
docs/csharp/language-reference/keywords/when.md	when (C# reference)
docs/csharp/language-reference/statements/exception-handling-statements.md	Exception-handling statements - throw, try-catch, try-finally, and try-catch-finally

[BillWagner]

This is a good start.

[BillWagner]

@copilot Please address all comments.

[Copilot]

@copilot Please address all comments.

All comments have been addressed in commit a2ca51e. The changes include: fixed punctuation in code comments, corrected emphasis in bullet points, converted heading format, changed to bullet list, and added periods to bullet points.

[BillWagner]

This is ready for final review.