---
title: Serializer
summary: API reference for Serializer.
status: draft
owner: saif-docgen
last_reviewed: 2026-09-15
library: SAIF.Framework.Common
reference_type: package
---

# Serializer

Static JSON/XML serialization helpers built on `DataContractJsonSerializer` and `XmlSerializer`, used to persist and reload plain data objects.

## Purpose
- Static JSON/XML serialization helpers built on `DataContractJsonSerializer` and `XmlSerializer`, used to persist and reload plain data objects.

## Context
- Namespace: `SAIF.Common`
- Assembly/package: `SAIF.Framework.Common`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| LoadFromJson<T>(string path) | `public static T LoadFromJson<T>(string path)` | Reads a JSON file from disk and deserializes it into a `T` instance. ([BR-058](<../../business-rules.md#br-058-json-serialization-uses-javascriptserializer-(system.web.extensions)-and-xml-serialization-uses-xmlserializer%3B-serializable-targets-must-be-reference-types-(where-t-%3A-class)-except-for-savetojson%3Ct%3E%2C-which-is-unconstrained>)) |
| SerializeToJson<T>(T value) | `public static string SerializeToJson<T>(T value)` | Serializes an in-memory `T` instance to a JSON string. ([BR-058](<../../business-rules.md#br-058-json-serialization-uses-javascriptserializer-(system.web.extensions)-and-xml-serialization-uses-xmlserializer%3B-serializable-targets-must-be-reference-types-(where-t-%3A-class)-except-for-savetojson%3Ct%3E%2C-which-is-unconstrained>)) |
| DeserializeFromJson<T>(string json) | `public static T DeserializeFromJson<T>(string json)` | Deserializes a JSON string into a `T` instance. ([BR-058](<../../business-rules.md#br-058-json-serialization-uses-javascriptserializer-(system.web.extensions)-and-xml-serialization-uses-xmlserializer%3B-serializable-targets-must-be-reference-types-(where-t-%3A-class)-except-for-savetojson%3Ct%3E%2C-which-is-unconstrained>)) |
| LoadFromXml<T>(string path) | `public static T LoadFromXml<T>(string path)` | Reads an XML file from disk and deserializes it into a `T` instance via `XmlSerializer`. ([BR-058](<../../business-rules.md#br-058-json-serialization-uses-javascriptserializer-(system.web.extensions)-and-xml-serialization-uses-xmlserializer%3B-serializable-targets-must-be-reference-types-(where-t-%3A-class)-except-for-savetojson%3Ct%3E%2C-which-is-unconstrained>), [BR-059](../../business-rules.md#br-059-xml-deserialization-that-produces-an-incompatible-type-yields-null-rather-than-throwing%2C-because-the-result-is-cast-with-as-t)) |
| SaveToJson<T>(T value, string path) | `public static void SaveToJson<T>(T value, string path)` | Serializes a `T` instance to JSON and writes it to disk. ([BR-058](<../../business-rules.md#br-058-json-serialization-uses-javascriptserializer-(system.web.extensions)-and-xml-serialization-uses-xmlserializer%3B-serializable-targets-must-be-reference-types-(where-t-%3A-class)-except-for-savetojson%3Ct%3E%2C-which-is-unconstrained>), [BR-060](../../business-rules.md#br-060-serialized-output-written-to-a-file-is-explicitly-flushed-before-the-writer-is-disposed)) |
| SaveToXml<T>(T value, string path) | `public static void SaveToXml<T>(T value, string path)` | Serializes a `T` instance to XML and writes it to disk. ([BR-058](<../../business-rules.md#br-058-json-serialization-uses-javascriptserializer-(system.web.extensions)-and-xml-serialization-uses-xmlserializer%3B-serializable-targets-must-be-reference-types-(where-t-%3A-class)-except-for-savetojson%3Ct%3E%2C-which-is-unconstrained>), [BR-060](../../business-rules.md#br-060-serialized-output-written-to-a-file-is-explicitly-flushed-before-the-writer-is-disposed)) |


## Sources
- `Common/SAIF.Common/Classes/Serializer.cs`