Taking full control of serialization

It’s possible that full control is needed (either for performance or custom serialization formats). To ensure the best performance possible, this is implemented with a special interface for each serialization engine. If one of the engines detects such a special interface, it will skip all the plumbing and directly call the interface with the right context.

Binary serialization

Custom binary serialization is not (yet) supported

Xml serialization

To gain the best performance possible using the xml serializer, a model should implement the ICustomXmlSerializable interface.

public class CustomXmlSerializationModel : ModelBase, ICustomXmlSerializable
{
    public string FirstName
    {
        get { return GetValue<string>(FirstNameProperty); }
        set { SetValue(FirstNameProperty, value); }
    }

    public static readonly PropertyData FirstNameProperty = RegisterProperty("FirstName", typeof(string), null);

    void ICustomXmlSerializable.Serialize(XElement xmlElement)
    {
        xmlElement.Add(new XElement("FirstName")
        {
            Value = FirstName
        });
    }

    void ICustomXmlSerializable.Deserialize(XElement xmlElement)
    {
        FirstName = xmlElement.Element("FirstName").Value;
    }
}

Json serialization

To gain the best performance possible using the json serializer, a model should implement the ICustomJsonSerializable interface.

public class CustomJsonSerializationModel : ModelBase, ICustomJsonSerializable
{
    public string FirstName
    {
        get { return GetValue<string>(FirstNameProperty); }
        set { SetValue(FirstNameProperty, value); }
    }

    public static readonly PropertyData FirstNameProperty = RegisterProperty("FirstName", typeof(string), null);

    void ICustomJsonSerializable.Serialize(JsonWriter jsonWriter)
    {
        jsonWriter.WriteStartObject();
        jsonWriter.WritePropertyName("FirstName");
        jsonWriter.WriteValue(FirstName);
        jsonWriter.WriteEndObject();
    }

    void ICustomJsonSerializable.Deserialize(JsonReader jsonReader)
    {
        // Note: this is probably not the fastest way to deserialize, but it's used to show the possibilities of the engine
        var jsonObject = JObject.Load(jsonReader);
        var jsonProperties = jsonObject.Properties().ToDictionary(x => x.Name, x => x);
        FirstName = (string)jsonProperties["FirstName"].Value;
    }
}

Contributions

We would like to thank the following contributors:

Want to contribute to the documentation? We have a guide for that!


Questions

Have a question about Catel? Use StackOverflow with the Catel tag!