Объектная модель > Действия с репозиториями и сущностями > AddError, AddInformation, AddWarning – валидация > AddInformation

Метод e.AddInformation() применяется, когда пользователю необходимо сообщить дополнительную информацию о работе с карточкой сущности или о выполняемом действии. Например, уведомить о том, что запись уже используется в другом справочнике и недоступна для редактирования. При регистрации документа можно уведомить о том, что он уже зарегистрирован:

Метод не прекращает текущие операции. Метод доступен в событиях:

Наименование события	Тип сущности, где вызывается событие
Серверные события
«До сохранения», «До удаления»	Все типы сущностей
«До подписания»	Документ
«До старта», «До рестарта», «До прекращения»	Задача
«До выполнения», «До принятия», «До отправки на доработку»	Задание, задание на приемку и уведомление
Клиентские события
«Показ формы», «Обновление формы»	Все типы сущностей
События свойств типа сущности
«Изменение значения контрола»	Все типы сущностей
События действия типа сущности
«Выполнение»	Все типы сущностей

В зависимости от того, в каком событии вызывается метод, количество его перегрузок может отличаться:

Перегрузки

AddInformation(string message)	Добавить информационное сообщение. Текст сообщения задается в коде
AddInformation(LocalizedString message)	Добавить информационное сообщение. Текст сообщения задается в виде строки локализации
AddInformation(IPropertyInfo propertyInfo, string message, params IPropertyInfo[] relatedPropertiesInfo)	Добавить информационное сообщение для свойства. Текст сообщения задается в коде
AddInformation(IPropertyInfo propertyInfo, LocalizedString message, params IPropertyInfo[] relatedPropertiesInfo)	Добавить информационное сообщение для свойства. Текст сообщения задается в виде строки локализации
AddInformation(string message, params IActionInfo[] actions)	Добавить информационное сообщение для действия. Текст сообщения задается в коде
AddInformation(LocalizedString message, params IActionInfo[] actions)	Добавить информационное сообщение для действия. Текст сообщения задается в виде строки локализации
AddInformation(IChildEntity childEntity, string message)	Добавить информационное сообщение для дочерней сущности. Текст сообщения задается в коде
AddInformation(IChildEntity childEntity, LocalizedString message)	Добавить информационное сообщение для дочерней сущности. Текст сообщения задается в виде строки локализации
AddInformation(IChildEntity childEntity, IPropertyInfo propertyInfo, string message, params IPropertyInfo[] relatedPropertiesInfo)	Добавить информационное сообщение для свойства дочерней сущности. Текст сообщения задается в коде
AddInformation(IChildEntity childEntity, IPropertyInfo propertyInfo, LocalizedString message, params IPropertyInfo[] relatedPropertiesInfo)	Добавить информационное сообщение для свойства дочерней сущности. Текст сообщения задается в виде строки локализации

Синтаксис

public void AddInformation(string message);

public void AddInformation(LocalizedString message);

public void AddInformation(IPropertyInfo propertyInfo, string message, params IPropertyInfo[] relatedPropertiesInfo);

public void AddInformation(IPropertyInfo propertyInfo, LocalizedString message, params IPropertyInfo[] relatedPropertiesInfo);

public void AddInformation(string message, params IActionInfo[] actions);

public void AddInformation(LocalizedString message, params IActionInfo[] actions);

public void AddInformation(IChildEntity childEntity, string message);

public void AddInformation(IChildEntity childEntity, LocalizedString message);

public void AddInformation(IChildEntity childEntity, IPropertyInfo propertyInfo, string message, params IPropertyInfo[] relatedPropertiesInfo);

public void AddInformation(IChildEntity childEntity, IPropertyInfo propertyInfo, LocalizedString message, params IPropertyInfo[] relatedPropertiesInfo);

Параметры

message – текст информационного сообщения;

propertyInfo – свойство сущности, для которого необходимо выполнить валидацию. Если свойство изменено, то информационное сообщение скрывается;

relatedPropertiesInfo – дополнительные свойства. В параметре указываются все свойства, которые влияют на значение свойства из параметра propertyInfo. Если хотя бы одно из дополнительных свойств изменено, информационное сообщение скрывается;

actions – действия, которые отображаются вместе с информационным сообщением. Если для продолжения работы пользователю необходимо выполнить действие, рядом с текстом можно добавить ссылку на действие;

childEntity – дочерняя сущность. Является строкой свойства-коллекции.

Пример. Уведомление о смене типа документа

// Показ сообщения о смене типа документа.
  e.AddInformation(ExchangeDocuments.Resources.ChangeDocumentTypeHint, _obj.Info.Actions.ChangeDocumentType);

СМ. ТАКЖЕ

AddInformation – добавить информационное сообщение

AddInformation – добавить информационное сообщение