Custom Converter

Introduction

If you need special behaviour of parsing / reading property from configuration class you can implement IIniConverter and use IniConverter Attribute. Library will call ParseReadValue when reading from ini file and FormatToWrite when saving.

Example:

Configuration class and converter implementation:

public class BoolBinaryConverterConfiguration
{
   [IniConverter(typeof(BoolBinaryConverter))]
   public bool TestBool { get; set; }
}

public class BoolBinaryConverter : IIniConverter
{
    private const string TrueValue = "1";
    private const string FalseValue = "0";

    public object ParseReadValue(string readValue, Type destinationType, IniContext iniContext)
    {
        return readValue == TrueValue;
    }

    public IniValue FormatToWrite(object objectToFormat, IniContext iniContext)
    {
        var castedValue = (bool)objectToFormat;

        iniContext.IniValue.Value = castedValue ? TrueValue : FalseValue;

        return iniContext.IniValue;
    }
}

Custom converter constructor parameters

You can pass CustomConverter parameters via IniConverter's property ConverterParameters. See example below.

public class IniConverterWithConstructorParameters
{
    [IniConverter(typeof(CustomIniConverterWithConstructor), new object[] { "Argument", 10 })]
    public TestEnum TestEnum { get; set; }
}

FormatToWrite

Method should return IniValue that will be written to ini file. If IniValue.Value is null library doesn't invoke Write method on IIniParser.

ParseReadValue

Method should return object that will be set as value to processed type. Type of returning object should match destinationType.

Additional converters built in library

• EnumStringConverter
• BoolBinaryConverter

Information in IniContext

1. IMemberInfoWrapper From this interface you can get Attributes, Type.
2. TypeDetailsInformation Detailed information about type that is being processed. UnderlyingTypeInformation is set only when type is nullable, IEnurable or IDictionary. UnderlyingKeyTypeInformation is only set for IDictionary and contains information about Key in this structure.
3. IniValue Default ini value for Section and Key described in How does it work?
4. IIniParser Interface to read or save from ini file.
5. IIniConverter Default converter for type that is being processed.