Converters

Converters are used to convert one type to another type, sometimes with additional parameters. For example, a value can be converted to a string using a given format. The BindingSystem provides examples of implementing converters in the code, making it easy to understand and extend this functionality. There are essentially 2 types of Converters: Safe and Unsafe. The latter may fail during conversion and invalidate the entire data retrieval pipeline.

Inspector View with a Converter

To add a new converter it is sufficient to implement IConverter<TFrom, TTo> interface:

public class MyConverter : IConverter<bool, string>
{
    public string Id => "My Converter";
    public string Description => "Transforms a bool into Valid or Invalid string";
    public bool IsSafe => true; // The conversion will always succeed
    public string Convert(bool value)
    {
        return value ? "Valid" : "Invalid";
    }
    public object Convert(object value) => Convert(value is bool bValue ? bValue : false);
}

Implement IContextConverter in addition to IConverter<,> if the converter needs to have information about bind source and path.

The system will automatically pick up the new converter and add it to converters list. To avoid auto registration of the new converter, add [HideMember] attribute over the class.

The converter must have a parameterless constructor.

When having multiple converters, the system will give the user the possiblity to select which converter to use.