Химсофт Вики - Вклад [ru]

Пользовательские функции

2026-10-20T10:13:15Z

Sidminik: /* Перечень доступных библиотек, классов и функций */

==Перечень доступных библиотек, классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл подключаемой библиотеки /<br>пространство имен (без приставки <code>.dll</code>)
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | <code>Chemsoft.Triteia.ReportClasses.dll</code>
| <code>IdNameItemDto</code>
| –
|-
| <code>DoubleIdNameItemDto</code>
| –
|-

| rowspan="2" | <code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
| <code>Rounding</code>
| <code>RoundBase</code>
|-
| <code>RoundMode</code>
| –
|-

| rowspan="6" | <code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
| rowspan="3" | <code>Formatters</code>
| <code>ClearTags</code>
|-
| <code>SetMarginByDots</code>
|-
| <code>CollapseNumbers</code>
|-

| rowspan="3" | <code>Getters</code>
| <code>FieldOr</code>
|-
| <code>JoinFields</code>
|-
| <code>DateOr</code>
|-

| rowspan="2" | <code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
| <code>AfterData</code>
| <code>AlignCells</code>
|-
| <code>KeyPressValidate</code>
| <code>BlockIfNotDigits</code>
|-

| rowspan="3" | <code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
| <code>ListControlDataFiller</code>
| <code>GetItemsArray</code>
|-

| rowspan="2" | <code>CheckedListSynchronizer</code>
| <code>HandleCheckboxChanged</code>
|-
| <code>HandleItemCheck</code>
|-

| rowspan="3" | <code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>
| rowspan="3" | <code>PersonNameFormatter</code>
| <code>NameInit</code>
|-
| <code>InitName</code>
|-
| <code>FullName</code>
|}

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

Пользовательские функции

2026-10-20T10:12:57Z

Sidminik: /* Перечень доступных библиотек, классов и функций */

==Перечень доступных библиотек, классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл подключаемой библиотеки /<br>пространство имен (без приставки <code>.dll</code>)
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | <code>Chemsoft.Triteia.ReportClasses.dll</code>
| <code>IdNameItemDto</code>
| –
|-
| <code>DoubleIdNameItemDto</code>
| –
|-

| rowspan="2" | <code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
| Rounding
| <code>RoundBase</code>
|-
| <code>RoundMode</code>
| –
|-

| rowspan="6" | <code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
| rowspan="3" | <code>Formatters</code>
| <code>ClearTags</code>
|-
| <code>SetMarginByDots</code>
|-
| <code>CollapseNumbers</code>
|-

| rowspan="3" | Getters
| <code>FieldOr</code>
|-
| <code>JoinFields</code>
|-
| <code>DateOr</code>
|-

| rowspan="2" | <code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
| <code>AfterData</code>
| <code>AlignCells</code>
|-
| <code>KeyPressValidate</code>
| <code>BlockIfNotDigits</code>
|-

| rowspan="3" | <code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
| <code>ListControlDataFiller</code>
| <code>GetItemsArray</code>
|-

| rowspan="2" | <code>CheckedListSynchronizer</code>
| <code>HandleCheckboxChanged</code>
|-
| <code>HandleItemCheck</code>
|-

| rowspan="3" | <code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>
| rowspan="3" | <code>PersonNameFormatter</code>
| <code>NameInit</code>
|-
| <code>InitName</code>
|-
| <code>FullName</code>
|}

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

Пользовательские функции

2026-10-20T10:11:34Z

Sidminik: /* Перечень доступных библиотек, классов и функций */

==Перечень доступных библиотек, классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл подключаемой библиотеки /<br>пространство имен (без приставки <code>.dll</code>)
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | <code>Chemsoft.Triteia.ReportClasses.dll</code>
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | <code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
| Rounding
| <code>RoundBase</code>
|-
| RoundMode
| –
|-

| rowspan="6" | <code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
| rowspan="3" | Formatters
| <code>ClearTags</code>
|-
| <code>SetMarginByDots</code>
|-
| <code>CollapseNumbers</code>
|-

| rowspan="3" | Getters
| <code>FieldOr</code>
|-
| <code>JoinFields</code>
|-
| <code>DateOr</code>
|-

| rowspan="2" | <code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
| AfterData
| <code>AlignCells</code>
|-
| KeyPressValidate
| <code>BlockIfNotDigits</code>
|-

| rowspan="3" | <code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
| ListControlDataFiller
| <code>GetItemsArray</code>
|-

| rowspan="2" | CheckedListSynchronizer
| <code>HandleCheckboxChanged</code>
|-
| <code>HandleItemCheck</code>
|-

| rowspan="3" | <code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>
| rowspan="3" | PersonNameFormatter
| <code>NameInit</code>
|-
| <code>InitName</code>
|-
| <code>FullName</code>
|}

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

Пользовательские функции

2026-10-20T10:10:36Z

Sidminik:

==Перечень доступных библиотек, классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл подключаемой библиотеки /<br>пространство имен (без приставки <code>.dll</code>)
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| <code>RoundBase</code>
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| <code>ClearTags</code>
|-
| <code>SetMarginByDots</code>
|-
| <code>CollapseNumbers</code>
|-

| rowspan="3" | Getters
| <code>FieldOr</code>
|-
| <code>JoinFields</code>
|-
| <code>DateOr</code>
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| <code>AlignCells</code>
|-
| KeyPressValidate
| <code>BlockIfNotDigits</code>
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| <code>GetItemsArray</code>
|-

| rowspan="2" | CheckedListSynchronizer
| <code>HandleCheckboxChanged</code>
|-
| <code>HandleItemCheck</code>
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| <code>NameInit</code>
|-
| <code>InitName</code>
|-
| <code>FullName</code>
|}

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

Пользовательские функции

2026-10-20T10:09:53Z

Sidminik: /* Перечень доступных классов и функций */

==Список подключаемых библиотек==
*<code>Chemsoft.Triteia.ReportClasses.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

==Перечень доступных классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл подключаемой библиотеки /<br>пространство имен (без приставки <code>.dll</code>)
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| <code>RoundBase</code>
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| <code>ClearTags</code>
|-
| <code>SetMarginByDots</code>
|-
| <code>CollapseNumbers</code>
|-

| rowspan="3" | Getters
| <code>FieldOr</code>
|-
| <code>JoinFields</code>
|-
| <code>DateOr</code>
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| <code>AlignCells</code>
|-
| KeyPressValidate
| <code>BlockIfNotDigits</code>
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| <code>GetItemsArray</code>
|-

| rowspan="2" | CheckedListSynchronizer
| <code>HandleCheckboxChanged</code>
|-
| <code>HandleItemCheck</code>
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| <code>NameInit</code>
|-
| <code>InitName</code>
|-
| <code>FullName</code>
|}

Пользовательские функции

2026-10-20T10:09:38Z

Sidminik: /* Перечень доступных классов и функций */

==Список подключаемых библиотек==
*<code>Chemsoft.Triteia.ReportClasses.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

==Перечень доступных классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл подключаемой библиотеки /<br>Пространство имен (без приставки <code>.dll</code>)
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| <code>RoundBase</code>
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| <code>ClearTags</code>
|-
| <code>SetMarginByDots</code>
|-
| <code>CollapseNumbers</code>
|-

| rowspan="3" | Getters
| <code>FieldOr</code>
|-
| <code>JoinFields</code>
|-
| <code>DateOr</code>
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| <code>AlignCells</code>
|-
| KeyPressValidate
| <code>BlockIfNotDigits</code>
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| <code>GetItemsArray</code>
|-

| rowspan="2" | CheckedListSynchronizer
| <code>HandleCheckboxChanged</code>
|-
| <code>HandleItemCheck</code>
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| <code>NameInit</code>
|-
| <code>InitName</code>
|-
| <code>FullName</code>
|}

Пользовательские функции

2026-10-20T10:09:29Z

Sidminik: /* Перечень доступных классов и функций */

==Список подключаемых библиотек==
*<code>Chemsoft.Triteia.ReportClasses.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

==Перечень доступных классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл подключаемой библиотеки/<br>Пространство имен (без приставки <code>.dll</code>)
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| <code>RoundBase</code>
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| <code>ClearTags</code>
|-
| <code>SetMarginByDots</code>
|-
| <code>CollapseNumbers</code>
|-

| rowspan="3" | Getters
| <code>FieldOr</code>
|-
| <code>JoinFields</code>
|-
| <code>DateOr</code>
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| <code>AlignCells</code>
|-
| KeyPressValidate
| <code>BlockIfNotDigits</code>
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| <code>GetItemsArray</code>
|-

| rowspan="2" | CheckedListSynchronizer
| <code>HandleCheckboxChanged</code>
|-
| <code>HandleItemCheck</code>
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| <code>NameInit</code>
|-
| <code>InitName</code>
|-
| <code>FullName</code>
|}

Пользовательские функции

2026-10-20T10:07:51Z

Sidminik: /* Перечень доступных классов и функций */

==Список подключаемых библиотек==
*<code>Chemsoft.Triteia.ReportClasses.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

==Перечень доступных классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл /<br>Пространство имен (без приставки <code>.dll</code>)
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| <code>RoundBase</code>
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| <code>ClearTags</code>
|-
| <code>SetMarginByDots</code>
|-
| <code>CollapseNumbers</code>
|-

| rowspan="3" | Getters
| <code>FieldOr</code>
|-
| <code>JoinFields</code>
|-
| <code>DateOr</code>
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| <code>AlignCells</code>
|-
| KeyPressValidate
| <code>BlockIfNotDigits</code>
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| <code>GetItemsArray</code>
|-

| rowspan="2" | CheckedListSynchronizer
| <code>HandleCheckboxChanged</code>
|-
| <code>HandleItemCheck</code>
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| <code>NameInit</code>
|-
| <code>InitName</code>
|-
| <code>FullName</code>
|}

Пользовательские функции

2026-10-20T10:05:31Z

Sidminik: /* Перечень доступных классов и функций */

==Список подключаемых библиотек==
*<code>Chemsoft.Triteia.ReportClasses.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

==Перечень доступных классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл /<br>Пространство имен<br>''(без приставки <code>.dll</code>)''
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| RoundBase
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| ClearTags
|-
| SetMarginByDots
|-
| CollapseNumbers
|-

| rowspan="3" | Getters
| FieldOr
|-
| JoinFields
|-
| DateOr
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| AlignCells
|-
| KeyPressValidate
| BlockIfNotDigits
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| GetItemsArray
|-

| rowspan="2" | CheckedListSynchronizer
| HandleCheckboxChanged
|-
| HandleItemCheck
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| NameInit
|-
| InitName
|-
| FullName
|}

Пользовательские функции

2026-10-20T10:05:09Z

Sidminik: /* Перечень доступных классов и функций */

==Список подключаемых библиотек==
*<code>Chemsoft.Triteia.ReportClasses.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

==Перечень доступных классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл /<br>Пространство имен (без приставки <code>.dll</code>)
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| RoundBase
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| ClearTags
|-
| SetMarginByDots
|-
| CollapseNumbers
|-

| rowspan="3" | Getters
| FieldOr
|-
| JoinFields
|-
| DateOr
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| AlignCells
|-
| KeyPressValidate
| BlockIfNotDigits
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| GetItemsArray
|-

| rowspan="2" | CheckedListSynchronizer
| HandleCheckboxChanged
|-
| HandleItemCheck
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| NameInit
|-
| InitName
|-
| FullName
|}

Пользовательские функции

2026-10-20T10:04:54Z

Sidminik: /* Перечень доступных классов и функций */

==Список подключаемых библиотек==
*<code>Chemsoft.Triteia.ReportClasses.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

==Перечень доступных классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл<br>Пространство имен (без приставки <code>.dll</code>)
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| RoundBase
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| ClearTags
|-
| SetMarginByDots
|-
| CollapseNumbers
|-

| rowspan="3" | Getters
| FieldOr
|-
| JoinFields
|-
| DateOr
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| AlignCells
|-
| KeyPressValidate
| BlockIfNotDigits
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| GetItemsArray
|-

| rowspan="2" | CheckedListSynchronizer
| HandleCheckboxChanged
|-
| HandleItemCheck
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| NameInit
|-
| InitName
|-
| FullName
|}

Пользовательские функции

2026-10-20T10:03:54Z

Sidminik: /* Перечень доступных классов и функций */

==Список подключаемых библиотек==
*<code>Chemsoft.Triteia.ReportClasses.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

==Перечень доступных классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл / Пространство имен
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| RoundBase
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| ClearTags
|-
| SetMarginByDots
|-
| CollapseNumbers
|-

| rowspan="3" | Getters
| FieldOr
|-
| JoinFields
|-
| DateOr
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| AlignCells
|-
| KeyPressValidate
| BlockIfNotDigits
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| GetItemsArray
|-

| rowspan="2" | CheckedListSynchronizer
| HandleCheckboxChanged
|-
| HandleItemCheck
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| NameInit
|-
| InitName
|-
| FullName
|}

Пользовательские функции

2026-10-20T10:03:26Z

Sidminik: /* Перечень доступных классов и функций */

==Список подключаемых библиотек==
*<code>Chemsoft.Triteia.ReportClasses.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

==Перечень доступных классов и функций==

{|class="wikitable" style="margin:auto; background-color: #fff;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| RoundBase
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| ClearTags
|-
| SetMarginByDots
|-
| CollapseNumbers
|-

| rowspan="3" | Getters
| FieldOr
|-
| JoinFields
|-
| DateOr
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| AlignCells
|-
| KeyPressValidate
| BlockIfNotDigits
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| GetItemsArray
|-

| rowspan="2" | CheckedListSynchronizer
| HandleCheckboxChanged
|-
| HandleItemCheck
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| NameInit
|-
| InitName
|-
| FullName
|}

Пользовательские функции

2026-10-20T10:02:37Z

Sidminik: /* Варианты подключения в основном классе отчета ReportScript */

==Список подключаемых библиотек==
*<code>Chemsoft.Triteia.ReportClasses.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Maths.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Cells.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Events.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Controls.dll</code>
*<code>Chemsoft.Triteia.ReportFunctions.Signatures.dll</code>

==Варианты подключения в основном классе отчета <code>ReportScript</code>==

===Подключение пространства имен===
<syntaxhighlight lang="C#">
using Chemsoft.Triteia.ReportFunctions.Signatures;
</syntaxhighlight>

В таком случае для использования в выражении перед именем функции требуется через точку указывать имя класса:
<syntaxhighlight lang="C#">
[PersonNameFormatter.FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

===Подключение класса===
<syntaxhighlight lang="C#">
using static Chemsoft.Triteia.ReportFunctions.Signatures.PersonNameFormatter;
</syntaxhighlight>

В таком случае для использования в выражении требуется указывать только имя функции:
<syntaxhighlight lang="C#">
[FullName([Main.surname], [Main.name], [Main.patronimyc])]
</syntaxhighlight>

<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''

Даже если функция используется только в выражениях и не используется во вкладке кода, она все-равно должна быть обязательно подключена во вкладке кода одним из двух способов!
</div>

==Перечень доступных классов и функций==

{| class="wikitable" style="width:100%; border-collapse:collapse; text-align:left;"
|- style="background:#f8f9fa; font-weight:bold; text-align:center;"
! style="width:40%;" | Файл
! style="width:30%;" | Класс
! style="width:30%;" | Функция
|-

| rowspan="2" | Chemsoft.Triteia.ReportClasses.dll
| IdNameItemDto
| –
|-
| DoubleIdNameItemDto
| –
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Maths.dll
| Rounding
| RoundBase
|-
| RoundMode
| –
|-

| rowspan="6" | Chemsoft.Triteia.ReportFunctions.Cells.dll
| rowspan="3" | Formatters
| ClearTags
|-
| SetMarginByDots
|-
| CollapseNumbers
|-

| rowspan="3" | Getters
| FieldOr
|-
| JoinFields
|-
| DateOr
|-

| rowspan="2" | Chemsoft.Triteia.ReportFunctions.Events.dll
| AfterData
| AlignCells
|-
| KeyPressValidate
| BlockIfNotDigits
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Controls.dll
| ListControlDataFiller
| GetItemsArray
|-

| rowspan="2" | CheckedListSynchronizer
| HandleCheckboxChanged
|-
| HandleItemCheck
|-

| rowspan="3" | Chemsoft.Triteia.ReportFunctions.Signatures.dll
| rowspan="3" | PersonNameFormatter
| NameInit
|-
| InitName
|-
| FullName
|}

Пользовательские функции

2026-10-20T09:45:46Z

Sidminik: /* Варианты подключения в основном классе отчета */

Пользовательские функции

2026-10-20T09:44:15Z

Sidminik: /* Подключение класса */

Пользовательские функции

2026-10-20T09:44:02Z

Sidminik:

Пользовательские функции

2026-10-20T09:36:57Z

Sidminik: /* Варианты подключения в основном классе отчета */

Пользовательские функции

2026-10-20T09:35:35Z

Sidminik: /* Подключение пространства имен */

Пользовательские функции

2026-10-20T09:34:58Z

Sidminik:

Пользовательские функции

2026-10-20T09:27:45Z

Sidminik: /* Список подключаемых библиотек */

Пользовательские функции

2026-10-20T09:27:24Z

Sidminik:

Пользовательские функции

2026-10-20T09:23:53Z

Sidminik: Полностью удалено содержимое страницы

Работа с ФИО

2026-10-20T09:19:39Z

Sidminik: /* Использование во вкладке кода */

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Большинство параметров сходны и описываются для всех функций совместно.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''.

==Выходные параметры==
*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==
Все 3 функции имеют общие входные параметры:
*<code>surname</code> - фамилия,
*<code>name</code> - имя,
*<code>patronymic</code> - отчество.

==Алгоритм==

#Лишние пробелы в начале и конце полученных на входе строк удаляются.
#Если какой-либо из параметров равен <code>null</code> или пустой строке, он игнорируется при сборке.
#Выполняется сборка по правилам и в последовательности, ожидаемых в выходных параметрах функции.
#Если все параметры пусты, возвращается значение по умолчанию <code>-</code>.

==Использование в выражениях==

<syntaxhighlight lang="C#">
// A_1
[FullName([Main.surname], [Main.name], [Main.patronimyc])]

// JL_2
[NameInit([Main.surname], [Main.name], [Main.patronymic])]

// M_1
[InitName([FioFilter.surname], [FioFilter.name], [FioFilter.patronymic])]
</syntaxhighlight>

==Использование во вкладке кода==

<syntaxhighlight lang="C#">

// NG_3
Cell103.Text = InitName(
Convert.ToString(Report.GetColumnValue("FioFilter_1.surname_1")),
Convert.ToString(Report.GetColumnValue("FioFilter_1.name_1")),
Convert.ToString(Report.GetColumnValue("FioFilter_1.patronymic_1"))
);
</syntaxhighlight>

==Подключение==
==Код класса==

<syntaxhighlight lang="C#">
using System.Text;

namespace Chemsoft.Triteia.ReportFunctions.Signatures;

/// <summary>
/// Вспомогательный (утилитарный) класс для представления ФИО в разных форматах
/// </summary>
public static class PersonNameFormatter
{
/// <summary>
/// Форматирует ФИО в вид: "Фамилия И.О."
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с фамилией и инициалами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string NameInit(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", cleanSurname, initials));
}

/// <summary>
/// Форматирует ФИО в вид: "И.О. Фамилия"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с инициалами и фамилией.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string InitName(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", initials, cleanSurname));
}

/// <summary>
/// Форматирует ФИО в вид: "Фамилия Имя Отчество"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Полная строка ФИО, разделенная пробелами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string FullName(string? surname, string? name, string? patronymic)
{
var sb = new StringBuilder();

var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

if (!string.IsNullOrEmpty(cleanSurname))
{
sb.Append(cleanSurname);
}

if (!string.IsNullOrEmpty(cleanName))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanName);
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanPatronymic);
}

return Output(sb.ToString());
}

/// <summary>
/// Формирует строку инициалов в формате "И.О." на основе очищенных имени и отчества.
/// </summary>
/// <param name="cleanName">Нормализованное имя (не должно быть <see langword="null"/>).</param>
/// <param name="cleanPatronymic">Нормализованное отчество (не должно быть <see langword="null"/>).</param>
/// <returns>
/// - или два инициала,<br/>
/// - или один инициал (если один из параметров пустой),<br/>
/// - или значение null (если оба параметра пустые).
/// </returns>
/// <remarks>
/// Метод берет первый символ от каждой непустой строки.
/// Если одна из строк пустая, соответствующий инициал пропускается
/// без добавления лишних пробелов или разделителей.
/// </remarks>
private static string? GetInitials(string? cleanName, string? cleanPatronymic)
{
if (string.IsNullOrEmpty(cleanName) && string.IsNullOrEmpty(cleanPatronymic))
{
return null;
}

var sb = new StringBuilder();

if (!string.IsNullOrEmpty(cleanName))
{
sb.Append(cleanName.Substring(0, 1));
sb.Append(".");
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
sb.Append(cleanPatronymic.Substring(0, 1));
sb.Append(".");
}

return sb.ToString();
}

/// <summary>
/// Выполняет финальную проверку сформированного ФИО
/// и заменяет пустые или некорректные значения на значение по умолчанию (дефис).
/// </summary>
/// <param name="field">Результирующая строка ФИО после форматирования.</param>
/// <returns>
/// - или исходную строку <paramref name="field"/>,<br/>
/// - или дефис <c>"-"</c> (если строка пуста или равна <c>"0"</c>).
/// </returns>
/// <remarks>
/// Метод гарантирует, что вызывающие методы не вернут пустую строку.
/// </remarks>
private static string Output(string field)
{
const string defaultEmptyValue = "-";
var trimmedField = field.Trim();

return string.IsNullOrEmpty(trimmedField) ? defaultEmptyValue : trimmedField;
}
}
</syntaxhighlight>

Работа с ФИО

2026-10-20T09:15:24Z

Sidminik: /* Использование в выражениях */

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Большинство параметров сходны и описываются для всех функций совместно.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''.

==Выходные параметры==
*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==
Все 3 функции имеют общие входные параметры:
*<code>surname</code> - фамилия,
*<code>name</code> - имя,
*<code>patronymic</code> - отчество.

==Алгоритм==

#Лишние пробелы в начале и конце полученных на входе строк удаляются.
#Если какой-либо из параметров равен <code>null</code> или пустой строке, он игнорируется при сборке.
#Выполняется сборка по правилам и в последовательности, ожидаемых в выходных параметрах функции.
#Если все параметры пусты, возвращается значение по умолчанию <code>-</code>.

==Использование в выражениях==

<syntaxhighlight lang="C#">
// A_1
[FullName([Main.surname], [Main.name], [Main.patronimyc])]

// JL_2
[NameInit([Main.surname], [Main.name], [Main.patronymic])]

// M_1
[InitName([FioFilter.surname], [FioFilter.name], [FioFilter.patronymic])]
</syntaxhighlight>

==Использование во вкладке кода==

<syntaxhighlight lang="C#">

</syntaxhighlight>

==Подключение==
==Код класса==

<syntaxhighlight lang="C#">
using System.Text;

namespace Chemsoft.Triteia.ReportFunctions.Signatures;

/// <summary>
/// Вспомогательный (утилитарный) класс для представления ФИО в разных форматах
/// </summary>
public static class PersonNameFormatter
{
/// <summary>
/// Форматирует ФИО в вид: "Фамилия И.О."
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с фамилией и инициалами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string NameInit(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", cleanSurname, initials));
}

/// <summary>
/// Форматирует ФИО в вид: "И.О. Фамилия"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с инициалами и фамилией.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string InitName(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", initials, cleanSurname));
}

/// <summary>
/// Форматирует ФИО в вид: "Фамилия Имя Отчество"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Полная строка ФИО, разделенная пробелами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string FullName(string? surname, string? name, string? patronymic)
{
var sb = new StringBuilder();

var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

if (!string.IsNullOrEmpty(cleanSurname))
{
sb.Append(cleanSurname);
}

if (!string.IsNullOrEmpty(cleanName))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanName);
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanPatronymic);
}

return Output(sb.ToString());
}

/// <summary>
/// Формирует строку инициалов в формате "И.О." на основе очищенных имени и отчества.
/// </summary>
/// <param name="cleanName">Нормализованное имя (не должно быть <see langword="null"/>).</param>
/// <param name="cleanPatronymic">Нормализованное отчество (не должно быть <see langword="null"/>).</param>
/// <returns>
/// - или два инициала,<br/>
/// - или один инициал (если один из параметров пустой),<br/>
/// - или значение null (если оба параметра пустые).
/// </returns>
/// <remarks>
/// Метод берет первый символ от каждой непустой строки.
/// Если одна из строк пустая, соответствующий инициал пропускается
/// без добавления лишних пробелов или разделителей.
/// </remarks>
private static string? GetInitials(string? cleanName, string? cleanPatronymic)
{
if (string.IsNullOrEmpty(cleanName) && string.IsNullOrEmpty(cleanPatronymic))
{
return null;
}

var sb = new StringBuilder();

if (!string.IsNullOrEmpty(cleanName))
{
sb.Append(cleanName.Substring(0, 1));
sb.Append(".");
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
sb.Append(cleanPatronymic.Substring(0, 1));
sb.Append(".");
}

return sb.ToString();
}

/// <summary>
/// Выполняет финальную проверку сформированного ФИО
/// и заменяет пустые или некорректные значения на значение по умолчанию (дефис).
/// </summary>
/// <param name="field">Результирующая строка ФИО после форматирования.</param>
/// <returns>
/// - или исходную строку <paramref name="field"/>,<br/>
/// - или дефис <c>"-"</c> (если строка пуста или равна <c>"0"</c>).
/// </returns>
/// <remarks>
/// Метод гарантирует, что вызывающие методы не вернут пустую строку.
/// </remarks>
private static string Output(string field)
{
const string defaultEmptyValue = "-";
var trimmedField = field.Trim();

return string.IsNullOrEmpty(trimmedField) ? defaultEmptyValue : trimmedField;
}
}
</syntaxhighlight>

Работа с ФИО

2026-10-20T09:14:18Z

Sidminik: /* Использование в выражениях */

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Большинство параметров сходны и описываются для всех функций совместно.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''.

==Выходные параметры==
*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==
Все 3 функции имеют общие входные параметры:
*<code>surname</code> - фамилия,
*<code>name</code> - имя,
*<code>patronymic</code> - отчество.

==Алгоритм==

#Лишние пробелы в начале и конце полученных на входе строк удаляются.
#Если какой-либо из параметров равен <code>null</code> или пустой строке, он игнорируется при сборке.
#Выполняется сборка по правилам и в последовательности, ожидаемых в выходных параметрах функции.
#Если все параметры пусты, возвращается значение по умолчанию <code>-</code>.

==Использование в выражениях==

<syntaxhighlight lang="C#">
// A_1
[FullName([Main.surname], [Main.name], [Main.patronimyc])]

// JL_2
[NameInit([Main.surname], [Main.name], [Main.patronymic])]

</syntaxhighlight>

==Использование во вкладке кода==

<syntaxhighlight lang="C#">

</syntaxhighlight>

==Подключение==
==Код класса==

<syntaxhighlight lang="C#">
using System.Text;

namespace Chemsoft.Triteia.ReportFunctions.Signatures;

/// <summary>
/// Вспомогательный (утилитарный) класс для представления ФИО в разных форматах
/// </summary>
public static class PersonNameFormatter
{
/// <summary>
/// Форматирует ФИО в вид: "Фамилия И.О."
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с фамилией и инициалами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string NameInit(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", cleanSurname, initials));
}

/// <summary>
/// Форматирует ФИО в вид: "И.О. Фамилия"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с инициалами и фамилией.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string InitName(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", initials, cleanSurname));
}

/// <summary>
/// Форматирует ФИО в вид: "Фамилия Имя Отчество"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Полная строка ФИО, разделенная пробелами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string FullName(string? surname, string? name, string? patronymic)
{
var sb = new StringBuilder();

var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

if (!string.IsNullOrEmpty(cleanSurname))
{
sb.Append(cleanSurname);
}

if (!string.IsNullOrEmpty(cleanName))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanName);
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanPatronymic);
}

return Output(sb.ToString());
}

/// <summary>
/// Формирует строку инициалов в формате "И.О." на основе очищенных имени и отчества.
/// </summary>
/// <param name="cleanName">Нормализованное имя (не должно быть <see langword="null"/>).</param>
/// <param name="cleanPatronymic">Нормализованное отчество (не должно быть <see langword="null"/>).</param>
/// <returns>
/// - или два инициала,<br/>
/// - или один инициал (если один из параметров пустой),<br/>
/// - или значение null (если оба параметра пустые).
/// </returns>
/// <remarks>
/// Метод берет первый символ от каждой непустой строки.
/// Если одна из строк пустая, соответствующий инициал пропускается
/// без добавления лишних пробелов или разделителей.
/// </remarks>
private static string? GetInitials(string? cleanName, string? cleanPatronymic)
{
if (string.IsNullOrEmpty(cleanName) && string.IsNullOrEmpty(cleanPatronymic))
{
return null;
}

var sb = new StringBuilder();

if (!string.IsNullOrEmpty(cleanName))
{
sb.Append(cleanName.Substring(0, 1));
sb.Append(".");
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
sb.Append(cleanPatronymic.Substring(0, 1));
sb.Append(".");
}

return sb.ToString();
}

/// <summary>
/// Выполняет финальную проверку сформированного ФИО
/// и заменяет пустые или некорректные значения на значение по умолчанию (дефис).
/// </summary>
/// <param name="field">Результирующая строка ФИО после форматирования.</param>
/// <returns>
/// - или исходную строку <paramref name="field"/>,<br/>
/// - или дефис <c>"-"</c> (если строка пуста или равна <c>"0"</c>).
/// </returns>
/// <remarks>
/// Метод гарантирует, что вызывающие методы не вернут пустую строку.
/// </remarks>
private static string Output(string field)
{
const string defaultEmptyValue = "-";
var trimmedField = field.Trim();

return string.IsNullOrEmpty(trimmedField) ? defaultEmptyValue : trimmedField;
}
}
</syntaxhighlight>

Работа с ФИО

2026-10-20T09:12:48Z

Sidminik: /* Использование в выражениях */

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Большинство параметров сходны и описываются для всех функций совместно.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''.

==Выходные параметры==
*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==
Все 3 функции имеют общие входные параметры:
*<code>surname</code> - фамилия,
*<code>name</code> - имя,
*<code>patronymic</code> - отчество.

==Алгоритм==

#Лишние пробелы в начале и конце полученных на входе строк удаляются.
#Если какой-либо из параметров равен <code>null</code> или пустой строке, он игнорируется при сборке.
#Выполняется сборка по правилам и в последовательности, ожидаемых в выходных параметрах функции.
#Если все параметры пусты, возвращается значение по умолчанию <code>-</code>.

==Использование в выражениях==

<syntaxhighlight lang="C#">
// A_1
[FullName([Main.surname], [Main.name], [Main.patronimyc])]

</syntaxhighlight>

==Использование во вкладке кода==

<syntaxhighlight lang="C#">

</syntaxhighlight>

==Подключение==
==Код класса==

<syntaxhighlight lang="C#">
using System.Text;

namespace Chemsoft.Triteia.ReportFunctions.Signatures;

/// <summary>
/// Вспомогательный (утилитарный) класс для представления ФИО в разных форматах
/// </summary>
public static class PersonNameFormatter
{
/// <summary>
/// Форматирует ФИО в вид: "Фамилия И.О."
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с фамилией и инициалами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string NameInit(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", cleanSurname, initials));
}

/// <summary>
/// Форматирует ФИО в вид: "И.О. Фамилия"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с инициалами и фамилией.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string InitName(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", initials, cleanSurname));
}

/// <summary>
/// Форматирует ФИО в вид: "Фамилия Имя Отчество"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Полная строка ФИО, разделенная пробелами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string FullName(string? surname, string? name, string? patronymic)
{
var sb = new StringBuilder();

var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

if (!string.IsNullOrEmpty(cleanSurname))
{
sb.Append(cleanSurname);
}

if (!string.IsNullOrEmpty(cleanName))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanName);
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanPatronymic);
}

return Output(sb.ToString());
}

/// <summary>
/// Формирует строку инициалов в формате "И.О." на основе очищенных имени и отчества.
/// </summary>
/// <param name="cleanName">Нормализованное имя (не должно быть <see langword="null"/>).</param>
/// <param name="cleanPatronymic">Нормализованное отчество (не должно быть <see langword="null"/>).</param>
/// <returns>
/// - или два инициала,<br/>
/// - или один инициал (если один из параметров пустой),<br/>
/// - или значение null (если оба параметра пустые).
/// </returns>
/// <remarks>
/// Метод берет первый символ от каждой непустой строки.
/// Если одна из строк пустая, соответствующий инициал пропускается
/// без добавления лишних пробелов или разделителей.
/// </remarks>
private static string? GetInitials(string? cleanName, string? cleanPatronymic)
{
if (string.IsNullOrEmpty(cleanName) && string.IsNullOrEmpty(cleanPatronymic))
{
return null;
}

var sb = new StringBuilder();

if (!string.IsNullOrEmpty(cleanName))
{
sb.Append(cleanName.Substring(0, 1));
sb.Append(".");
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
sb.Append(cleanPatronymic.Substring(0, 1));
sb.Append(".");
}

return sb.ToString();
}

/// <summary>
/// Выполняет финальную проверку сформированного ФИО
/// и заменяет пустые или некорректные значения на значение по умолчанию (дефис).
/// </summary>
/// <param name="field">Результирующая строка ФИО после форматирования.</param>
/// <returns>
/// - или исходную строку <paramref name="field"/>,<br/>
/// - или дефис <c>"-"</c> (если строка пуста или равна <c>"0"</c>).
/// </returns>
/// <remarks>
/// Метод гарантирует, что вызывающие методы не вернут пустую строку.
/// </remarks>
private static string Output(string field)
{
const string defaultEmptyValue = "-";
var trimmedField = field.Trim();

return string.IsNullOrEmpty(trimmedField) ? defaultEmptyValue : trimmedField;
}
}
</syntaxhighlight>

Работа с ФИО

2026-10-20T09:12:32Z

Sidminik: /* Использование в выражениях */

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Большинство параметров сходны и описываются для всех функций совместно.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''.

==Выходные параметры==
*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==
Все 3 функции имеют общие входные параметры:
*<code>surname</code> - фамилия,
*<code>name</code> - имя,
*<code>patronymic</code> - отчество.

==Алгоритм==

#Лишние пробелы в начале и конце полученных на входе строк удаляются.
#Если какой-либо из параметров равен <code>null</code> или пустой строке, он игнорируется при сборке.
#Выполняется сборка по правилам и в последовательности, ожидаемых в выходных параметрах функции.
#Если все параметры пусты, возвращается значение по умолчанию <code>-</code>.

==Использование в выражениях==

<syntaxhighlight lang="C#">
// A_1
[FullName([Main.surname], [Main.name],[Main.patronimyc])]

</syntaxhighlight>

==Использование во вкладке кода==

<syntaxhighlight lang="C#">

</syntaxhighlight>

==Подключение==
==Код класса==

<syntaxhighlight lang="C#">
using System.Text;

namespace Chemsoft.Triteia.ReportFunctions.Signatures;

/// <summary>
/// Вспомогательный (утилитарный) класс для представления ФИО в разных форматах
/// </summary>
public static class PersonNameFormatter
{
/// <summary>
/// Форматирует ФИО в вид: "Фамилия И.О."
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с фамилией и инициалами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string NameInit(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", cleanSurname, initials));
}

/// <summary>
/// Форматирует ФИО в вид: "И.О. Фамилия"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с инициалами и фамилией.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string InitName(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", initials, cleanSurname));
}

/// <summary>
/// Форматирует ФИО в вид: "Фамилия Имя Отчество"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Полная строка ФИО, разделенная пробелами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string FullName(string? surname, string? name, string? patronymic)
{
var sb = new StringBuilder();

var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

if (!string.IsNullOrEmpty(cleanSurname))
{
sb.Append(cleanSurname);
}

if (!string.IsNullOrEmpty(cleanName))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanName);
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanPatronymic);
}

return Output(sb.ToString());
}

/// <summary>
/// Формирует строку инициалов в формате "И.О." на основе очищенных имени и отчества.
/// </summary>
/// <param name="cleanName">Нормализованное имя (не должно быть <see langword="null"/>).</param>
/// <param name="cleanPatronymic">Нормализованное отчество (не должно быть <see langword="null"/>).</param>
/// <returns>
/// - или два инициала,<br/>
/// - или один инициал (если один из параметров пустой),<br/>
/// - или значение null (если оба параметра пустые).
/// </returns>
/// <remarks>
/// Метод берет первый символ от каждой непустой строки.
/// Если одна из строк пустая, соответствующий инициал пропускается
/// без добавления лишних пробелов или разделителей.
/// </remarks>
private static string? GetInitials(string? cleanName, string? cleanPatronymic)
{
if (string.IsNullOrEmpty(cleanName) && string.IsNullOrEmpty(cleanPatronymic))
{
return null;
}

var sb = new StringBuilder();

if (!string.IsNullOrEmpty(cleanName))
{
sb.Append(cleanName.Substring(0, 1));
sb.Append(".");
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
sb.Append(cleanPatronymic.Substring(0, 1));
sb.Append(".");
}

return sb.ToString();
}

/// <summary>
/// Выполняет финальную проверку сформированного ФИО
/// и заменяет пустые или некорректные значения на значение по умолчанию (дефис).
/// </summary>
/// <param name="field">Результирующая строка ФИО после форматирования.</param>
/// <returns>
/// - или исходную строку <paramref name="field"/>,<br/>
/// - или дефис <c>"-"</c> (если строка пуста или равна <c>"0"</c>).
/// </returns>
/// <remarks>
/// Метод гарантирует, что вызывающие методы не вернут пустую строку.
/// </remarks>
private static string Output(string field)
{
const string defaultEmptyValue = "-";
var trimmedField = field.Trim();

return string.IsNullOrEmpty(trimmedField) ? defaultEmptyValue : trimmedField;
}
}
</syntaxhighlight>

Работа с ФИО

2026-10-20T09:09:42Z

Sidminik:

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Большинство параметров сходны и описываются для всех функций совместно.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''.

==Выходные параметры==
*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==
Все 3 функции имеют общие входные параметры:
*<code>surname</code> - фамилия,
*<code>name</code> - имя,
*<code>patronymic</code> - отчество.

==Алгоритм==

#Лишние пробелы в начале и конце полученных на входе строк удаляются.
#Если какой-либо из параметров равен <code>null</code> или пустой строке, он игнорируется при сборке.
#Выполняется сборка по правилам и в последовательности, ожидаемых в выходных параметрах функции.
#Если все параметры пусты, возвращается значение по умолчанию <code>-</code>.

==Использование в выражениях==

<syntaxhighlight lang="C#">

</syntaxhighlight>

==Использование во вкладке кода==

<syntaxhighlight lang="C#">

</syntaxhighlight>

==Подключение==
==Код класса==

<syntaxhighlight lang="C#">
using System.Text;

namespace Chemsoft.Triteia.ReportFunctions.Signatures;

/// <summary>
/// Вспомогательный (утилитарный) класс для представления ФИО в разных форматах
/// </summary>
public static class PersonNameFormatter
{
/// <summary>
/// Форматирует ФИО в вид: "Фамилия И.О."
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с фамилией и инициалами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string NameInit(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", cleanSurname, initials));
}

/// <summary>
/// Форматирует ФИО в вид: "И.О. Фамилия"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с инициалами и фамилией.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string InitName(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", initials, cleanSurname));
}

/// <summary>
/// Форматирует ФИО в вид: "Фамилия Имя Отчество"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Полная строка ФИО, разделенная пробелами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string FullName(string? surname, string? name, string? patronymic)
{
var sb = new StringBuilder();

var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

if (!string.IsNullOrEmpty(cleanSurname))
{
sb.Append(cleanSurname);
}

if (!string.IsNullOrEmpty(cleanName))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanName);
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanPatronymic);
}

return Output(sb.ToString());
}

/// <summary>
/// Формирует строку инициалов в формате "И.О." на основе очищенных имени и отчества.
/// </summary>
/// <param name="cleanName">Нормализованное имя (не должно быть <see langword="null"/>).</param>
/// <param name="cleanPatronymic">Нормализованное отчество (не должно быть <see langword="null"/>).</param>
/// <returns>
/// - или два инициала,<br/>
/// - или один инициал (если один из параметров пустой),<br/>
/// - или значение null (если оба параметра пустые).
/// </returns>
/// <remarks>
/// Метод берет первый символ от каждой непустой строки.
/// Если одна из строк пустая, соответствующий инициал пропускается
/// без добавления лишних пробелов или разделителей.
/// </remarks>
private static string? GetInitials(string? cleanName, string? cleanPatronymic)
{
if (string.IsNullOrEmpty(cleanName) && string.IsNullOrEmpty(cleanPatronymic))
{
return null;
}

var sb = new StringBuilder();

if (!string.IsNullOrEmpty(cleanName))
{
sb.Append(cleanName.Substring(0, 1));
sb.Append(".");
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
sb.Append(cleanPatronymic.Substring(0, 1));
sb.Append(".");
}

return sb.ToString();
}

/// <summary>
/// Выполняет финальную проверку сформированного ФИО
/// и заменяет пустые или некорректные значения на значение по умолчанию (дефис).
/// </summary>
/// <param name="field">Результирующая строка ФИО после форматирования.</param>
/// <returns>
/// - или исходную строку <paramref name="field"/>,<br/>
/// - или дефис <c>"-"</c> (если строка пуста или равна <c>"0"</c>).
/// </returns>
/// <remarks>
/// Метод гарантирует, что вызывающие методы не вернут пустую строку.
/// </remarks>
private static string Output(string field)
{
const string defaultEmptyValue = "-";
var trimmedField = field.Trim();

return string.IsNullOrEmpty(trimmedField) ? defaultEmptyValue : trimmedField;
}
}
</syntaxhighlight>

Работа с ФИО

2026-10-20T09:09:04Z

Sidminik: /* Использование в выражениях */

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Большинство параметров сходны и описываются для всех функций совместно.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''.

==Выходные параметры==
*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==
Все 3 функции имеют общие входные параметры:
*<code>surname</code> - фамилия,
*<code>name</code> - имя,
*<code>patronymic</code> - отчество.

==Алгоритм==

#Лишние пробелы в начале и конце полученных на входе строк удаляются.
#Если какой-либо из параметров равен <code>null</code> или пустой строке, он игнорируется при сборке.
#Выполняется сборка по правилам и в последовательности, ожидаемых в выходных параметрах функции.
#Если все параметры пусты, возвращается значение по умолчанию <code>-</code>.

==Использование в выражениях==

<syntaxhighlight lang="C#">

==Использование во вкладке кода==
==Подключение==
==Код класса==

<syntaxhighlight lang="C#">
using System.Text;

namespace Chemsoft.Triteia.ReportFunctions.Signatures;

/// <summary>
/// Вспомогательный (утилитарный) класс для представления ФИО в разных форматах
/// </summary>
public static class PersonNameFormatter
{
/// <summary>
/// Форматирует ФИО в вид: "Фамилия И.О."
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с фамилией и инициалами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string NameInit(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", cleanSurname, initials));
}

/// <summary>
/// Форматирует ФИО в вид: "И.О. Фамилия"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с инициалами и фамилией.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string InitName(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", initials, cleanSurname));
}

/// <summary>
/// Форматирует ФИО в вид: "Фамилия Имя Отчество"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Полная строка ФИО, разделенная пробелами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string FullName(string? surname, string? name, string? patronymic)
{
var sb = new StringBuilder();

var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

if (!string.IsNullOrEmpty(cleanSurname))
{
sb.Append(cleanSurname);
}

if (!string.IsNullOrEmpty(cleanName))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanName);
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanPatronymic);
}

return Output(sb.ToString());
}

/// <summary>
/// Формирует строку инициалов в формате "И.О." на основе очищенных имени и отчества.
/// </summary>
/// <param name="cleanName">Нормализованное имя (не должно быть <see langword="null"/>).</param>
/// <param name="cleanPatronymic">Нормализованное отчество (не должно быть <see langword="null"/>).</param>
/// <returns>
/// - или два инициала,<br/>
/// - или один инициал (если один из параметров пустой),<br/>
/// - или значение null (если оба параметра пустые).
/// </returns>
/// <remarks>
/// Метод берет первый символ от каждой непустой строки.
/// Если одна из строк пустая, соответствующий инициал пропускается
/// без добавления лишних пробелов или разделителей.
/// </remarks>
private static string? GetInitials(string? cleanName, string? cleanPatronymic)
{
if (string.IsNullOrEmpty(cleanName) && string.IsNullOrEmpty(cleanPatronymic))
{
return null;
}

var sb = new StringBuilder();

if (!string.IsNullOrEmpty(cleanName))
{
sb.Append(cleanName.Substring(0, 1));
sb.Append(".");
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
sb.Append(cleanPatronymic.Substring(0, 1));
sb.Append(".");
}

return sb.ToString();
}

/// <summary>
/// Выполняет финальную проверку сформированного ФИО
/// и заменяет пустые или некорректные значения на значение по умолчанию (дефис).
/// </summary>
/// <param name="field">Результирующая строка ФИО после форматирования.</param>
/// <returns>
/// - или исходную строку <paramref name="field"/>,<br/>
/// - или дефис <c>"-"</c> (если строка пуста или равна <c>"0"</c>).
/// </returns>
/// <remarks>
/// Метод гарантирует, что вызывающие методы не вернут пустую строку.
/// </remarks>
private static string Output(string field)
{
const string defaultEmptyValue = "-";
var trimmedField = field.Trim();

return string.IsNullOrEmpty(trimmedField) ? defaultEmptyValue : trimmedField;
}
}
</syntaxhighlight>

Работа с ФИО

2026-10-20T09:08:08Z

Sidminik: /* Алгоритм */

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Большинство параметров сходны и описываются для всех функций совместно.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''.

==Выходные параметры==
*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==
Все 3 функции имеют общие входные параметры:
*<code>surname</code> - фамилия,
*<code>name</code> - имя,
*<code>patronymic</code> - отчество.

==Алгоритм==

#Лишние пробелы в начале и конце полученных на входе строк удаляются.
#Если какой-либо из параметров равен <code>null</code> или пустой строке, он игнорируется при сборке.
#Выполняется сборка по правилам и в последовательности, ожидаемых в выходных параметрах функции.
#Если все параметры пусты, возвращается значение по умолчанию <code>-</code>.

==Использование в выражениях==
==Использование во вкладке кода==
==Подключение==
==Код класса==

<syntaxhighlight lang="C#">
using System.Text;

namespace Chemsoft.Triteia.ReportFunctions.Signatures;

/// <summary>
/// Вспомогательный (утилитарный) класс для представления ФИО в разных форматах
/// </summary>
public static class PersonNameFormatter
{
/// <summary>
/// Форматирует ФИО в вид: "Фамилия И.О."
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с фамилией и инициалами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string NameInit(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", cleanSurname, initials));
}

/// <summary>
/// Форматирует ФИО в вид: "И.О. Фамилия"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с инициалами и фамилией.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string InitName(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", initials, cleanSurname));
}

/// <summary>
/// Форматирует ФИО в вид: "Фамилия Имя Отчество"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Полная строка ФИО, разделенная пробелами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string FullName(string? surname, string? name, string? patronymic)
{
var sb = new StringBuilder();

var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

if (!string.IsNullOrEmpty(cleanSurname))
{
sb.Append(cleanSurname);
}

if (!string.IsNullOrEmpty(cleanName))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanName);
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanPatronymic);
}

return Output(sb.ToString());
}

/// <summary>
/// Формирует строку инициалов в формате "И.О." на основе очищенных имени и отчества.
/// </summary>
/// <param name="cleanName">Нормализованное имя (не должно быть <see langword="null"/>).</param>
/// <param name="cleanPatronymic">Нормализованное отчество (не должно быть <see langword="null"/>).</param>
/// <returns>
/// - или два инициала,<br/>
/// - или один инициал (если один из параметров пустой),<br/>
/// - или значение null (если оба параметра пустые).
/// </returns>
/// <remarks>
/// Метод берет первый символ от каждой непустой строки.
/// Если одна из строк пустая, соответствующий инициал пропускается
/// без добавления лишних пробелов или разделителей.
/// </remarks>
private static string? GetInitials(string? cleanName, string? cleanPatronymic)
{
if (string.IsNullOrEmpty(cleanName) && string.IsNullOrEmpty(cleanPatronymic))
{
return null;
}

var sb = new StringBuilder();

if (!string.IsNullOrEmpty(cleanName))
{
sb.Append(cleanName.Substring(0, 1));
sb.Append(".");
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
sb.Append(cleanPatronymic.Substring(0, 1));
sb.Append(".");
}

return sb.ToString();
}

/// <summary>
/// Выполняет финальную проверку сформированного ФИО
/// и заменяет пустые или некорректные значения на значение по умолчанию (дефис).
/// </summary>
/// <param name="field">Результирующая строка ФИО после форматирования.</param>
/// <returns>
/// - или исходную строку <paramref name="field"/>,<br/>
/// - или дефис <c>"-"</c> (если строка пуста или равна <c>"0"</c>).
/// </returns>
/// <remarks>
/// Метод гарантирует, что вызывающие методы не вернут пустую строку.
/// </remarks>
private static string Output(string field)
{
const string defaultEmptyValue = "-";
var trimmedField = field.Trim();

return string.IsNullOrEmpty(trimmedField) ? defaultEmptyValue : trimmedField;
}
}
</syntaxhighlight>

Работа с ФИО

2026-10-20T09:03:24Z

Sidminik: /* Код функций */

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Большинство параметров сходны и описываются для всех функций совместно.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''.

==Выходные параметры==
*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==
Все 3 функции имеют общие входные параметры:
*<code>surname</code> - фамилия,
*<code>name</code> - имя,
*<code>patronymic</code> - отчество.

==Алгоритм==
==Использование в выражениях==
==Использование во вкладке кода==
==Подключение==
==Код класса==

<syntaxhighlight lang="C#">
using System.Text;

namespace Chemsoft.Triteia.ReportFunctions.Signatures;

/// <summary>
/// Вспомогательный (утилитарный) класс для представления ФИО в разных форматах
/// </summary>
public static class PersonNameFormatter
{
/// <summary>
/// Форматирует ФИО в вид: "Фамилия И.О."
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с фамилией и инициалами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string NameInit(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", cleanSurname, initials));
}

/// <summary>
/// Форматирует ФИО в вид: "И.О. Фамилия"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с инициалами и фамилией.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string InitName(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", initials, cleanSurname));
}

/// <summary>
/// Форматирует ФИО в вид: "Фамилия Имя Отчество"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Полная строка ФИО, разделенная пробелами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string FullName(string? surname, string? name, string? patronymic)
{
var sb = new StringBuilder();

var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

if (!string.IsNullOrEmpty(cleanSurname))
{
sb.Append(cleanSurname);
}

if (!string.IsNullOrEmpty(cleanName))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanName);
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanPatronymic);
}

return Output(sb.ToString());
}

/// <summary>
/// Формирует строку инициалов в формате "И.О." на основе очищенных имени и отчества.
/// </summary>
/// <param name="cleanName">Нормализованное имя (не должно быть <see langword="null"/>).</param>
/// <param name="cleanPatronymic">Нормализованное отчество (не должно быть <see langword="null"/>).</param>
/// <returns>
/// - или два инициала,<br/>
/// - или один инициал (если один из параметров пустой),<br/>
/// - или значение null (если оба параметра пустые).
/// </returns>
/// <remarks>
/// Метод берет первый символ от каждой непустой строки.
/// Если одна из строк пустая, соответствующий инициал пропускается
/// без добавления лишних пробелов или разделителей.
/// </remarks>
private static string? GetInitials(string? cleanName, string? cleanPatronymic)
{
if (string.IsNullOrEmpty(cleanName) && string.IsNullOrEmpty(cleanPatronymic))
{
return null;
}

var sb = new StringBuilder();

if (!string.IsNullOrEmpty(cleanName))
{
sb.Append(cleanName.Substring(0, 1));
sb.Append(".");
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
sb.Append(cleanPatronymic.Substring(0, 1));
sb.Append(".");
}

return sb.ToString();
}

/// <summary>
/// Выполняет финальную проверку сформированного ФИО
/// и заменяет пустые или некорректные значения на значение по умолчанию (дефис).
/// </summary>
/// <param name="field">Результирующая строка ФИО после форматирования.</param>
/// <returns>
/// - или исходную строку <paramref name="field"/>,<br/>
/// - или дефис <c>"-"</c> (если строка пуста или равна <c>"0"</c>).
/// </returns>
/// <remarks>
/// Метод гарантирует, что вызывающие методы не вернут пустую строку.
/// </remarks>
private static string Output(string field)
{
const string defaultEmptyValue = "-";
var trimmedField = field.Trim();

return string.IsNullOrEmpty(trimmedField) ? defaultEmptyValue : trimmedField;
}
}
</syntaxhighlight>

Работа с ФИО

2026-10-20T09:03:03Z

Sidminik: /* Код функций */

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Большинство параметров сходны и описываются для всех функций совместно.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''.

==Выходные параметры==
*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==
Все 3 функции имеют общие входные параметры:
*<code>surname</code> - фамилия,
*<code>name</code> - имя,
*<code>patronymic</code> - отчество.

==Алгоритм==
==Использование в выражениях==
==Использование во вкладке кода==
==Подключение==
==Код функций==

<syntaxhighlight lang="C#">
using System.Text;

namespace Chemsoft.Triteia.ReportFunctions.Signatures;

/// <summary>
/// Вспомогательный (утилитарный) класс для представления ФИО в разных форматах
/// </summary>
public static class PersonNameFormatter
{
/// <summary>
/// Форматирует ФИО в вид: "Фамилия И.О."
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с фамилией и инициалами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string NameInit(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", cleanSurname, initials));
}

/// <summary>
/// Форматирует ФИО в вид: "И.О. Фамилия"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Строка с инициалами и фамилией.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string InitName(string? surname, string? name, string? patronymic)
{
var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

var initials = GetInitials(cleanName, cleanPatronymic);

return Output(string.Join(" ", initials, cleanSurname));
}

/// <summary>
/// Форматирует ФИО в вид: "Фамилия Имя Отчество"
/// </summary>
/// <param name="surname">Фамилия</param>
/// <param name="name">Имя</param>
/// <param name="patronymic">Отчество</param>
/// <returns>Полная строка ФИО, разделенная пробелами.</returns>
/// <remarks>
/// 1. Лишние пробелы в начале и конце строк удаляются.<br/>
/// 2. Если какой-либо из параметров равен <see langword="null"/> или пустой строке,
/// он игнорируется при сборке.<br/>
/// 3. Если все параметры пусты, вернет значение по умолчанию для пустой строки методом <see cref="Output"/>.
/// </remarks>
public static string FullName(string? surname, string? name, string? patronymic)
{
var sb = new StringBuilder();

var cleanSurname = surname?.Trim();
var cleanName = name?.Trim();
var cleanPatronymic = patronymic?.Trim();

if (!string.IsNullOrEmpty(cleanSurname))
{
sb.Append(cleanSurname);
}

if (!string.IsNullOrEmpty(cleanName))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanName);
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
if (sb.Length > 0) sb.Append(" ");
sb.Append(cleanPatronymic);
}

return Output(sb.ToString());
}

/// <summary>
/// Формирует строку инициалов в формате "И.О." на основе очищенных имени и отчества.
/// </summary>
/// <param name="cleanName">Нормализованное имя (не должно быть <see langword="null"/>).</param>
/// <param name="cleanPatronymic">Нормализованное отчество (не должно быть <see langword="null"/>).</param>
/// <returns>
/// - или два инициала,<br/>
/// - или один инициал (если один из параметров пустой),<br/>
/// - или значение null (если оба параметра пустые).
/// </returns>
/// <remarks>
/// Метод берет первый символ от каждой непустой строки.
/// Если одна из строк пустая, соответствующий инициал пропускается
/// без добавления лишних пробелов или разделителей.
/// </remarks>
private static string? GetInitials(string? cleanName, string? cleanPatronymic)
{
if (string.IsNullOrEmpty(cleanName) && string.IsNullOrEmpty(cleanPatronymic))
{
return null;
}

var sb = new StringBuilder();

if (!string.IsNullOrEmpty(cleanName))
{
sb.Append(cleanName.Substring(0, 1));
sb.Append(".");
}

if (!string.IsNullOrEmpty(cleanPatronymic))
{
sb.Append(cleanPatronymic.Substring(0, 1));
sb.Append(".");
}

return sb.ToString();
}

/// <summary>
/// Выполняет финальную проверку сформированного ФИО
/// и заменяет пустые или некорректные значения на значение по умолчанию (дефис).
/// </summary>
/// <param name="field">Результирующая строка ФИО после форматирования.</param>
/// <returns>
/// - или исходную строку <paramref name="field"/>,<br/>
/// - или дефис <c>"-"</c> (если строка пуста или равна <c>"0"</c>).
/// </returns>
/// <remarks>
/// Метод гарантирует, что вызывающие методы не вернут пустую строку.
/// </remarks>
private static string Output(string field)
{
const string defaultEmptyValue = "-";
var trimmedField = field.Trim();

return string.IsNullOrEmpty(trimmedField) ? defaultEmptyValue : trimmedField;
}
}
</syntaxhighlight>

Работа с ФИО

2026-10-20T09:01:54Z

Sidminik: /* Входные параметры */

Работа с ФИО

2026-10-20T08:59:57Z

Sidminik:

Работа с ФИО

2026-10-20T08:59:07Z

Sidminik:

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО: <code>FullName</code>, <code>NameInit</code> и <code>InitName</code>.

Функции принципиально отличаются друг от друга только '''''выходными параметрами'''''. Остальные параметры сходны и описываются для всех функций совместно.

==Выходные параметры==

*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==

==Алгоритм==
==Использование в выражениях==
==Использование во вкладке кода==
==Подключение==
==Код функций==

Работа с ФИО

2026-10-20T08:56:29Z

Sidminik:

Класс <code>PersonNameFormatter</code> - содержит 3 функции для работы с ФИО:

==Выходные параметры==

*<code>FullName</code> - выводит полный вариант в формате "Фамилия Имя Отчество";
*<code>NameInit</code> - выводит фамилию и инициалы в формате "Фамилия И.О.";
*<code>InitName</code> - выводит инициалы и фамилию в формате "И.О. Фамилия".

==Входные параметры==

==Алгоритм==
==Использование в выражениях==
==Использование во вкладке кода==
==Подключение==
==Код функций==

Валидатор ввода чисел

2026-10-20T08:48:42Z

Sidminik: Новая страница: «==Входные параметры== ==Выходные параметры== ==Алгоритм== ==Использование в выражениях== ==Использование во вкладке кода== ==Подключение== ==Код функции==»

==Входные параметры==
==Выходные параметры==
==Алгоритм==
==Использование в выражениях==
==Использование во вкладке кода==
==Подключение==
==Код функции==

Группировка последовательности целых чисел

2026-10-20T08:48:33Z

Абзацный отступ ячейки по уровню вложенности

2026-10-20T08:48:20Z

Удаление HTML-тегов

2026-10-20T08:48:12Z

Выравнивание текста по условию

2026-10-20T08:48:06Z

Форматирование даты

2026-10-20T08:48:00Z

Объединение текстовых значений

2026-10-20T08:47:48Z

Обработка пустых значений

2026-10-20T08:47:37Z

Работа с ФИО

2026-10-20T08:47:22Z

Отчеты

2026-10-20T08:45:33Z

Sidminik: /* AR - Дизайнер документов */

==<span style="color: #a71d2a"><b>AR</b> - </span>[[Основная техническая информация о сервисе отчетов]]==
==[[Дизайнер документов]]==

==<span style="color: #a71d2a"><b>AR</b> - </span>[[Руководство по настройке шаблонов]]==
==<span style="color: #a71d2a"><b>AR</b> - </span>[[Описание готовых шаблонов|Описание стандартных форм готовых шаблонов]]==

Управление фильтрацией из кода

2026-10-20T08:45:04Z

Sidminik: /* Свойство AutoFill */

Возможностей '''''автоматической фильтрации''''' достаточно для большинства случаев.

В исключительных случаях есть возможность управлять '''''фильтрацией вручную'''''.

==Свойства и методы управления фильтрацией==

===Свойство AutoFill===
*управляет заполнением элемента;
*используется элементами, которые могут показывать список данных, например, <code>ListBoxControl</code>;
*перед тем как показать диалог, дизайнер заполняет данными такие элементы (по умолчанию свойство равно <code>true</code>);
*если его отключить, элемент заполняться не будет, и это нужно сделать самостоятельно, вызвав метод <code>FillData</code>:

<syntaxhighlight lang="C#">
ListBox1.FillData();
</syntaxhighlight>

===Свойство AutoFilter===
*управляет фильтрацией данных;
*используется всеми элементами управления;
*после того как диалог закрыт кнопкой <code>ОК</code>, дизайнер выполняет фильтрацию данных автоматически (по умолчанию свойство равно <code>true</code>);
*если его отключить, фильтрация выполняться не будет, и это нужно сделать самостоятельно, вызвав метод <code>FilterData</code>:

<syntaxhighlight lang="C#">
ListBox1.FilterData();
</syntaxhighlight>

Округление

2026-10-20T08:44:22Z

Sidminik: /* Код функции */

Функция <code>Rounding.RoundBase()</code> - предназначена для гибкого округления числовых значений.

В отличие от стандартных функций - поддерживает работу с отрицательными разрядами и округление до значащих цифр.

==Входные параметры==
*<code>value</code> (''Double'') - исходное число для обработки;
*<code>digits</code> (''Object'')
**при <code>Mode = 1</code> - количество знаков после запятой (положительное) или до запятой (отрицательное);
**при <code>Mode = 0</code> - количество значащих цифр;
*<code>mode</code> (''Object'') - режим работы:
**<code>1</code> (''ToDecimalPlace'') - десятичное округление;
**<code>0</code> (''ToSignificantPlace'') - значащие цифры.

==Выходные параметры==
*<code>String</code> - возвращает строковое представление числа.

==Алгоритм==
Функция работает по методу <code>Away From Zero</code> (округление от нуля).

'''Режим 1''' (''десятичное округление''):
*вычисляется множитель;
*число умножается на множитель, округляется до целого и делится обратно;
*при положительном n результат форматируется с фиксированным количеством нулей после запятой.

'''Режим 0''' (''значащие цифры''):
*определяется порядок числа через десятичный логарифм;
*вычисляется масштабный коэффициент, чтобы оставить ровно <code>n</code> цифр;
*число масштабируется, округляется и возвращается в исходный порядок;
*результат преобразуется в компактную строку (удаляются лишние нули в конце).

==Использование в выражениях==

''Принципы использования:''

{|class="wikitable" style="margin:auto; background-color: #fff; width:100%"
|-
!Исходное значение
!Синтаксис в соответствии с формулой
!Результат
|-
|style="text-align:right"|12345
|<syntaxhighlight lang="C#">[Rounding.RoundBase([DataBase.field], 2, 1)]</syntaxhighlight>
|style="text-align:right"|12345,00
|-
|style="text-align:right"|12345.00
|<syntaxhighlight lang="C#">[Rounding.RoundBase([DataBase.field], 0, 1)]</syntaxhighlight>
|style="text-align:right"|12345
|-
|style="text-align:right"|12345.01
|<syntaxhighlight lang="C#">[Rounding.RoundBase([DataBase.field], -2, 1)]</syntaxhighlight>
|style="text-align:right"|12300
|-
|style="text-align:right"|555.55
|<syntaxhighlight lang="C#">[Rounding.RoundBase([DataBase.field], 1, 0)]</syntaxhighlight>
|style="text-align:right"|600
|-
|}

''Примеры:''
<syntaxhighlight lang="C#">
// A_2
[Rounding.RoundBase(ToDouble([Main.table_size]) / 1000, 0, 1)]

// R_3
[ResultOrDash(Rounding.RoundBase(First([Main.min_avg]), 2, 1))]

</syntaxhighlight>

==Использование во вкладке кода==

<syntaxhighlight lang="C#">
// NG_2
string result = Rounding.RoundBase(normDouble, scaleInt, 1);

// NG_2
finalResult4 = Rounding.RoundBase(storage.Results[0], 2, 1);

// NG_2
return Rounding.RoundBase(firstNum, 2, 1) + " (" + Rounding.RoundBase(secondNum, 0, 1) + ")";
</syntaxhighlight>

==Подключение==

==Код функции==
<syntaxhighlight lang="csharp">
/// <summary>
/// В отличие от стандартных функций, поддерживает работу с отрицательными разрядами и округление до значащих цифр.
/// </summary>
/// <param name="value">Исходное число для обработки;</param>
/// <param name="digits">
/// - при Mode = 1 - количество знаков после запятой (положительное) или до запятой (отрицательное);<br/>
/// - при Mode = 0 - количество значащих цифр;
/// </param>
/// <param name="mode">
/// — <see cref="RoundMode.ToDecimalPlace"/> — десятичное округление;<br/>
/// — <see cref="RoundMode.ToSignificantPlace"/> — значащие цифры
/// </param>
/// <returns>Строковое представление числа, округленного по заданным параметрам</returns>
/// <exception cref="ArgumentOutOfRangeException"></exception>
public static string RoundBase(double value, int digits, RoundMode mode)
{
if (value == 0)
return "0";

double result;
switch (mode)
{
case RoundMode.ToDecimalPlace:
double factor = Math.Pow(10, digits);
result = Math.Round(value * factor, 0, MidpointRounding.AwayFromZero) / factor;
return result.ToString("F" + Math.Max(0, digits));
case RoundMode.ToSignificantPlace:
double scale = Math.Pow(10, Math.Floor(Math.Log10(Math.Abs(value))) + 1 - digits);
result = Math.Round(value / scale, 0, MidpointRounding.AwayFromZero) * scale;
return result.ToString("G");
default:
throw new ArgumentOutOfRangeException(nameof(mode), Localization.InvalidRoundMode);
}
}

/// <summary>
/// Режим округления.
/// </summary>
public enum RoundMode
{
ToSignificantPlace = 0,
ToDecimalPlace = 1
}
</syntaxhighlight>

Округление

2026-10-20T08:43:39Z

Sidminik:

Функция <code>Rounding.RoundBase()</code> - предназначена для гибкого округления числовых значений.

В отличие от стандартных функций - поддерживает работу с отрицательными разрядами и округление до значащих цифр.

==Входные параметры==
*<code>value</code> (''Double'') - исходное число для обработки;
*<code>digits</code> (''Object'')
**при <code>Mode = 1</code> - количество знаков после запятой (положительное) или до запятой (отрицательное);
**при <code>Mode = 0</code> - количество значащих цифр;
*<code>mode</code> (''Object'') - режим работы:
**<code>1</code> (''ToDecimalPlace'') - десятичное округление;
**<code>0</code> (''ToSignificantPlace'') - значащие цифры.

==Выходные параметры==
*<code>String</code> - возвращает строковое представление числа.

==Алгоритм==
Функция работает по методу <code>Away From Zero</code> (округление от нуля).

'''Режим 1''' (''десятичное округление''):
*вычисляется множитель;
*число умножается на множитель, округляется до целого и делится обратно;
*при положительном n результат форматируется с фиксированным количеством нулей после запятой.

'''Режим 0''' (''значащие цифры''):
*определяется порядок числа через десятичный логарифм;
*вычисляется масштабный коэффициент, чтобы оставить ровно <code>n</code> цифр;
*число масштабируется, округляется и возвращается в исходный порядок;
*результат преобразуется в компактную строку (удаляются лишние нули в конце).

==Использование в выражениях==

''Принципы использования:''

{|class="wikitable" style="margin:auto; background-color: #fff; width:100%"
|-
!Исходное значение
!Синтаксис в соответствии с формулой
!Результат
|-
|style="text-align:right"|12345
|<syntaxhighlight lang="C#">[Rounding.RoundBase([DataBase.field], 2, 1)]</syntaxhighlight>
|style="text-align:right"|12345,00
|-
|style="text-align:right"|12345.00
|<syntaxhighlight lang="C#">[Rounding.RoundBase([DataBase.field], 0, 1)]</syntaxhighlight>
|style="text-align:right"|12345
|-
|style="text-align:right"|12345.01
|<syntaxhighlight lang="C#">[Rounding.RoundBase([DataBase.field], -2, 1)]</syntaxhighlight>
|style="text-align:right"|12300
|-
|style="text-align:right"|555.55
|<syntaxhighlight lang="C#">[Rounding.RoundBase([DataBase.field], 1, 0)]</syntaxhighlight>
|style="text-align:right"|600
|-
|}

''Примеры:''
<syntaxhighlight lang="C#">
// A_2
[Rounding.RoundBase(ToDouble([Main.table_size]) / 1000, 0, 1)]

// R_3
[ResultOrDash(Rounding.RoundBase(First([Main.min_avg]), 2, 1))]

</syntaxhighlight>

==Использование во вкладке кода==

<syntaxhighlight lang="C#">
// NG_2
string result = Rounding.RoundBase(normDouble, scaleInt, 1);

// NG_2
finalResult4 = Rounding.RoundBase(storage.Results[0], 2, 1);

// NG_2
return Rounding.RoundBase(firstNum, 2, 1) + " (" + Rounding.RoundBase(secondNum, 0, 1) + ")";
</syntaxhighlight>

==Код функции==
<syntaxhighlight lang="csharp">
/// <summary>
/// В отличие от стандартных функций, поддерживает работу с отрицательными разрядами и округление до значащих цифр.
/// </summary>
/// <param name="value">Исходное число для обработки;</param>
/// <param name="digits">
/// - при Mode = 1 - количество знаков после запятой (положительное) или до запятой (отрицательное);<br/>
/// - при Mode = 0 - количество значащих цифр;
/// </param>
/// <param name="mode">
/// — <see cref="RoundMode.ToDecimalPlace"/> — десятичное округление;<br/>
/// — <see cref="RoundMode.ToSignificantPlace"/> — значащие цифры
/// </param>
/// <returns>Строковое представление числа, округленного по заданным параметрам</returns>
/// <exception cref="ArgumentOutOfRangeException"></exception>
public static string RoundBase(double value, int digits, RoundMode mode)
{
if (value == 0)
return "0";

double result;
switch (mode)
{
case RoundMode.ToDecimalPlace:
double factor = Math.Pow(10, digits);
result = Math.Round(value * factor, 0, MidpointRounding.AwayFromZero) / factor;
return result.ToString("F" + Math.Max(0, digits));
case RoundMode.ToSignificantPlace:
double scale = Math.Pow(10, Math.Floor(Math.Log10(Math.Abs(value))) + 1 - digits);
result = Math.Round(value / scale, 0, MidpointRounding.AwayFromZero) * scale;
return result.ToString("G");
default:
throw new ArgumentOutOfRangeException(nameof(mode), Localization.InvalidRoundMode);
}
}

/// <summary>
/// Режим округления.
/// </summary>
public enum RoundMode
{
ToSignificantPlace = 0,
ToDecimalPlace = 1
}
</syntaxhighlight>