В атрибуте Type указывается имя класса, описывающего кастомный Condition, а в качестве значения атрибута Assembly указывается имя сборки, в которой реализован этот класс.
Исходный код
Класс кастомного условия наследует класс CheckCondition:
using System.Xml;
namespace WorkflowForms.Conditions
{
public class CustomCheckCondition : CheckCondition
{
public CustomCheckCondition(IWorkflowForm form, XmlNode node)
: base(form, node)
{
}
// Метод Check будет вызываться столько раз, какова длина массива в <Item>.
// И будет проверяться только первый элемент каждой строки.
protected override bool Check(object value)
{
// Для корректного получения значения из праметра value используется статический класс ValueConverter.
// Класс описан в Common.dll и предоставляет широкий набор методов поддерживающих различные типы данных.
var str = ValueConverter.GetStringValue(value);
// Здесь необходимо реализовать логику проверки переданного значения
return true;
}
}
}
Такие условия могут обрабатывать линейные массивы:
В этом случае наследуется класс ComparisonCondition:
using System.Xml;
namespace WorkflowForms.Conditions
{
public class CustomComparisonCondition : ComparisonCondition
{
public CustomComparisonCondition(IWorkflowForm form, XmlNode node)
: base(form, node)
{
}
public override void InternalInit(XmlNode node, IWorkflowForm form)
{
base.InternalInit(node, form);
}
// Метод CheckValue будет вызываться столько раз, какова длина массива в <Item>.
// И будет проверяться только первый элемент каждой строки.
protected override bool CheckValue(object[] values)
{
if (values.Length > 1)
{
// Здесь необходимо реализовать логику проверки переданного значения
}
return false;
}
}
}
Параметр values будет содержать массив значений, описанных в тэгах <Item>.
Если в тэгах <Item> передаются массивы, то метод CheckValue будет вызываться по количеству элементов в коротком массиве.
Дополнительные элементы
Описание условия
Кастомные условия могут иметь тэги для задания дополнительных данных, необходимых для проверки значений:
Для получения значения тэга <Something> используется механизм привязки данных. Такой подход позволяет получать актуальные данные в момент проверки условия, а не фиксировать значение при загрузки формы.
Исходный код класса:
using System.Xml;
using WorkflowForms.DataBindings;
namespace WorkflowForms.Conditions
{
public class CustomCheckCondition : CheckCondition
{
private const string SOMETHING_ELEMENT = "Something";
private IDataBinding somethingDataBinding;
public CustomCheckCondition(IWorkflowForm form, XmlNode node)
: base(form, node)
{
/*
* Для получения значения тэга <Something> используем
* механизм привязки данных
*/
somethingDataBinding = XmlParser.GetRequiredElementDataBinding(
this, form, node,
new DataBindingProvider(),
SOMETHING_ELEMENT,
Name, GetType());
}
// Метод Check будет вызываться столько раз, какова длина массива в <Item>.
// И будет проверяться только первый элемент каждой строки.
protected override bool Check(object value)
{
// Для корректного получения значения из праметра value используется статический класс ValueConverter.
// Класс описан в Common.dll и предоставляет широкий набор методов поддерживающих различные типы данных.
var str1 = ValueConverter.GetStringValue(value);
// Динамически получаем актуальное значение в момент проверки условия
var str2 = somethingDataBinding.GetStringValue();
// Здесь необходимо реализовать логику проверки переданного значения
return true;
}
}
}
Для получения привязки к источнику данных в тэге <Something> используем статический метод GetRequiredElementDataBinding().
