Обработка поля: различия между версиями
Внешний вид
Sidminik (обсуждение | вклад) |
Sidminik (обсуждение | вклад) Нет описания правки |
||
| Строка 1: | Строка 1: | ||
Функция <code>FieldOr</code> - предназначена для универсальной обработки пустых значений (<code>NULL</code>, пустые строки, пробелы, отсутствующие даты или числа). | |||
==Входные параметры== | ==Входные параметры== | ||
*<code>field</code> - входное значение для проверки и форматирования; | |||
*<code>defaultValue</code> - строка, возвращаемая если значение пустое (по умолчанию "-"); | |||
*<code>prefix</code> - префикс, добавляемый к непустому значению; | |||
*<code>suffix</code> - суффикс, добавляемый к непустому значению. | |||
==Выходные параметры== | ==Выходные параметры== | ||
==Алгоритм== | ==Алгоритм== | ||
*Анализирует входной строковый параметр | |||
*По умолчанию заменяет пустоту на дефис ("-"), но позволяет задать любое строковое значение по умолчанию | |||
==Использование в выражениях== | ==Использование в выражениях== | ||
==Использование во вкладке кода== | ==Использование во вкладке кода== | ||
Версия от 01:11, 21 октября 2026
Функция FieldOr - предназначена для универсальной обработки пустых значений (NULL, пустые строки, пробелы, отсутствующие даты или числа).
Входные параметры
field- входное значение для проверки и форматирования;defaultValue- строка, возвращаемая если значение пустое (по умолчанию "-");prefix- префикс, добавляемый к непустому значению;suffix- суффикс, добавляемый к непустому значению.
Выходные параметры
Алгоритм
- Анализирует входной строковый параметр
- По умолчанию заменяет пустоту на дефис ("-"), но позволяет задать любое строковое значение по умолчанию
Использование в выражениях
Использование во вкладке кода
Подключение
Код функции
/// <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}";
}