Обработка поля: различия между версиями
Внешний вид
Sidminik (обсуждение | вклад) |
Sidminik (обсуждение | вклад) |
||
| Строка 3: | Строка 3: | ||
==Входные параметры== | ==Входные параметры== | ||
*<code>field</code> - входное значение для проверки и форматирования; | *<code>field</code> - входное значение для проверки и форматирования; | ||
*<code>defaultValue</code> - строка, возвращаемая если значение пустое (по умолчанию | *<code>defaultValue</code> - строка, возвращаемая если значение пустое (по умолчанию <code>-</code>); | ||
*<code>prefix</code> - префикс, добавляемый к непустому значению; | *<code>prefix</code> - префикс, добавляемый к непустому значению; | ||
*<code>suffix</code> - суффикс, добавляемый к непустому значению. | *<code>suffix</code> - суффикс, добавляемый к непустому значению. | ||
Версия от 01:18, 21 октября 2026
Функция FieldOr - предназначена для универсальной обработки пустых значений (NULL, пустые строки, пробелы, отсутствующие даты или числа).
Входные параметры
field- входное значение для проверки и форматирования;defaultValue- строка, возвращаемая если значение пустое (по умолчанию-);prefix- префикс, добавляемый к непустому значению;suffix- суффикс, добавляемый к непустому значению.
Выходные параметры
- или строка
defaultValue, если значение пустое; - или входящая строка с добавлением префикса (при наличии) и суффикса (при наличии).
Алгоритм
- Анализирует входной строковый параметр
- По умолчанию заменяет пустоту на дефис ("-"), но позволяет задать любое строковое значение по умолчанию
Использование в выражениях
Использование во вкладке кода
Подключение
Код функции
/// <summary>
/// Универсальная обработка пустых значений (NULL, пустые строки, пробелы, отсутствующие даты или числа).<br/>
/// По умолчанию заменяет пустоту на дефис ("-"), но позволяет задать любое строковое значение по умолчанию.<br/>
/// При необходимости можно добавить перегрузку для типов данных.
/// </summary>
/// <param name="field">Входное значение для проверки и форматирования.</param>
/// <param name="defaultValue">Строка, возвращаемая если значение пустое (по умолчанию "-").</param>
/// <param name="prefix">Префикс, добавляемый к непустому значению.</param>
/// <param name="suffix">Суффикс, добавляемый к непустому значению.</param>
/// <returns>
/// - или строку <paramref name="defaultValue"/>, если значение пустое;<br/>
/// - или строковое представление объекта с добавлением префикса (при наличии) и суффикса (при наличии).
/// </returns>
public static string FieldOr(object? field, string defaultValue = "-", string prefix = "", string suffix = "")
{
if (field == null || field == DBNull.Value)
{
return defaultValue;
}
var fieldString = field.ToString();
return string.IsNullOrWhiteSpace(fieldString)
? defaultValue
: $"{prefix}{fieldString}{suffix}";
}