День 2305. #ЧтоНовенького #TipsAndTricks
Используем Расширения C# 14 для Написания Защитных Конструкций
Продолжаем рассматривать примеры применения ещё не вышедших расширений в C# 14 (первая часть тут).

В C# есть много хороших защитных конструкций, расположенных поверх статических классов исключений, таких как ArgumentNullException, ArgumentOutOfRangeException и т.д. Например, ArgumentException.ThrowIfNullOrEmpty, ArgumentException.ThrowIfNullOrWhiteSpace. Теперь мы можем легко их расширить!

Расширения в C#14 позволяют добавлять новые защитные конструкции к существующим классам. Например, если мы хотим иметь такую «жутко полезную» семантику, как: «Выбрасывать исключение, если строка содержит ровно один символ», мы можем сделать что-то вроде этого:

static class EnumExtensions
{
  extension(ArgumentException)
  {
    public static void 
     ThrowIfHasOneCharacter(
      string arg, 
      [CallerArgumentExpression("arg")]
      string? paramName = null)
    {
      if (arg.Length == 1)
        throw new ArgumentException($"Аргумент '{paramName}' не может иметь только один символ.", paramName);
    }
  }
}

Теперь мы можем использовать этот метод-расширение так:

public void MyMethod(string arg)
{
  ArgumentException.ThrowIfHasOneCharacter(arg);
  …
}

Он прекрасно вливается в семейство существующих защитных конструкций:

public void MyMethod(string arg)
{
  ArgumentException.ThrowIfNullOrEmpty(arg);
  ArgumentException.ThrowIfHasOneCharacter(arg);
  …
}

Конечно, это слишком упрощённый пример. Но вы поняли идею. Мы получаем что-то похожее на существующие защитные конструкции.

Заметьте, что до C#14 этого сделать нельзя, т.к. здесь мы использовали статический метод-расширение, который можно вызвать так:

ArgumentException.ThrowIfHasOneCharacter(…);

Существующие на данный момент методы-расширения позволяют делать только экземплярные методы, которые пришлось бы вызывать так:

var ex = new ArgumentException();
ex.ThrowIfHasOneCharacter(…);

Источник: https://steven-giesel.com/blogPost/e2552b7a-293a-4f46-892f-95a0cd677e4d/writing-new-guards-with-extensions-in-c-14