Язык программирования C#9 и платформа .NET5 - Эндрю Троелсен

любые ошибки в словаре, когда в параметре передается пустая строка или null. Если передается допустимое значение propertyName, то возвращаются ошибки, обнаруженные для указанного свойства. Если параметр не соответствует какому-либо свойству (или ошибки для свойства отсутствуют), тогда метод возвратит null.

public IEnumerable GetErrors(string propertyName)

{

  if (string.IsNullOrEmpty(propertyName))

  {

    return _errors.Values;

  }

  return _errors.ContainsKey(propertyName)

    ? _errors[propertyName]

    : null;

}

Финальный набор вспомогательных методов будет добавлять одну или большее число ошибок для свойства либо очищать все ошибки для свойства (или всех свойств). Не следует забывать о вызове вспомогательного метода OnErrorsChanged() каждый раз, когда словарь изменяется.

private void AddError(string propertyName, string error)

{

  AddErrors(propertyName, new List<string> { error });

}

private void AddErrors(

  string propertyName, IList<string> errors)

{

  if (errors == null || !errors.Any())

  {

    return;

  }

  var changed = false;

  if (!_errors.ContainsKey(propertyName))

  {

    _errors.Add(propertyName, new List<string>());

    changed = true;

  }

  foreach (var err in errors)

  {

    if (_errors[propertyName].Contains(err)) continue;

    _errors[propertyName].Add(err);

    changed = true;

  }

  if (changed)

  {

    OnErrorsChanged(propertyName);

  }

}

protected void ClearErrors(string propertyName = "")

{

  if (string.IsNullOrEmpty(propertyName))

  {

    _errors.Clear();

  }

  else

  {

    _errors.Remove(propertyName);

  }

  OnErrorsChanged(propertyName);

}

Возникает вопрос: когда приведенный выше код активизируется? Механизм привязки прослушивает событие ErrorsChanged и обновляет пользовательский интерфейс, если в коллекции ошибок для выражения привязки возникает изменение. Но код проверки по-прежнему нуждается в триггере для запуска. Доступны два механизма, которые обсуждаются далее.

Использование интерфейса INotifyDataErrorInfo для проверки достоверности

Одним из мест выполнения проверки на предмет ошибок являются блоки set для свойств, как демонстрируется в показанном ниже примере, упрощенном до единственной проверки на равенство свойства Make значению ModelT:

public string Make

{

  get { return _make; }

  set

  {

    if (value == _make) return;

    _make = value;

    if (Make == "ModelT")

    {

      AddError(nameof(Make), "Too Old");

    }

    else

    {

      ClearErrors(nameof(Make));

    }

  OnPropertyChanged(nameof(Make));

    OnPropertyChanged(nameof(Color));

  }

}

Основная проблема такого подхода состоит в том, что вам приходится сочетать логику проверки достоверности с блоками set для свойств, что делает код труднее в чтении и сопровождении.

Комбинирование IDataErrorInfo С INotifyDataErrorInfo для проверки достоверности

В предыдущем разделе было показано, что реализацию интерфейса IDataErrorInfo можно добавить к частичному классу, т.е. обновлять блоки set не понадобится. Кроме того, индексатор автоматически вызывается при возникновении события PropertyChanged в свойстве. Комбинирование IDataErrorInfo и INotifyDataErrorInfo предоставляет дополнительные возможности для проверки достоверности из INotifyDataErrorInfo, а также отделение от блоков set, обеспечиваемое IDataErrorInfo.

Цель применения IDataErrorInfo не в том, чтобы запускать проверку достоверности, а в том, чтобы гарантировать вызов кода проверки, который задействует INotifyDataErrorInfo, каждый раз, когда для объекта генерируется событие PropertyChanged. Поскольку интерфейс IDataErrorInfo не используется для проверки достоверности, необходимо всегда возвращать string.Empty из индексатора. Модифицируйте индексатор и вспомогательный метод CheckMakeAndColor() следующим образом:

public string this[string columnName]

{

  get

  {

    ClearErrors(columnName);

    switch (columnName)

    {

      case nameof(Id):

        break;

      case nameof(Make):

        CheckMakeAndColor();

        if (Make == "ModelT")

        {

          AddError(nameof(Make), "Too Old");

          hasError = true;

        }

        break;

      case nameof(Color):

        CheckMakeAndColor();

        break;

      case nameof(PetName):

        break;

    }

    return string.Empty;

  }

}

internal bool CheckMakeAndColor()

{

  if (Make == "Chevy" && Color == "Pink")

  {

    AddError(nameof(Make), $"{Make}'s don't come in {Color}");

  AddError(nameof(Color),

      $"{Make}'s don't come in {Color}");

    return true;

  }

  return false;

}

Запустите приложение, выберите автомобиль Chevy и измените цвет на Pink. В дополнение к декораторам красного цвета вокруг текстовых полей Make и Model будет также отображаться декоратор в виде красного прямоугольника, охватывающего целиком всю сетку, в которой находятся поля с детальной информацией об автомобиле (рис. 28.3).

Это еще одно преимущество применения интерфейса INotifyDataErrorInfo. В дополнение к элементам управления, которые содержат ошибки, элемент управления, определяющий контекст данных, также декорируется шаблоном отображения ошибки.

Отображение всех ошибок

Свойство Errors класса Validation возвращает все ошибки проверки достоверности для конкретного объекта в форме объектов ValidationError. Каждый объект ValidationError имеет свойство ErrorContent, которое содержит список сообщений об ошибках для свойства. Это означает, что сообщения об ошибках, которые нужно отобразить, находятся в списке внутри списка. Чтобы вывести их надлежащим образом, понадобится создать элемент ListBox, содержащий еще один элемент ListBox. Звучит слегка запутанно, но вскоре все прояснится.

Первым делом добавьте одну строку в DetailsGrid и удостоверьтесь в том, что значение свойства Height элемента Window составляет не менее 300. Поместите в последнюю строку элемент управления ListBox и привяжите его свойство ItemsSource к DetailsGrid, используя Validation.Errors для Path:

<ListBox Grid.Row="6" Grid.Column="0" Grid.ColumnSpan="2"

    ItemsSource="{Binding ElementName=DetailsGrid, Path=(Validation.Errors)}">

</ListBox>

Добавьте к ListBox элемент DataTemplate, а в него — элемент управления ListBox, привязанный к свойству ErrorContent. Контекстом данных для каждого элемента ListBoxItem в этом случае является объект ValidationError, так что устанавливать контекст данных не придется, а только путь. Установите путь привязки