Library

AppendTo

Executes the conversion and appends the result to an existing file rather than overwriting it. Use when accumulating records across multiple converter calls.

CSV Configuration

Three settings control how CSV, TAB, and PIPE-delimited input is parsed: whether the first row is column headers, whether fields are enclosed in quotes, and whether to skip the first row entirely.

PrettyPrintTo

Formats JSON, YAML, XML, or HTML with human-readable indentation and line breaks. All other formats (CSV, TAB, PIPE, etc.) are returned as-is.

RegisterKnownStructType

Registers a custom struct or complex nested type so the automapper can correctly deserialize it when using SaveTo<T>. Call before WithInput for each type that the mapper cannot resolve automatically.

RenderTo

Executes the conversion and returns the result in memory - as a string, database insert, file, or dynamic object. Use RenderTo when you need the converted output immediately in code rather than persisted to disk.

SaveTo

Executes the conversion and writes the result to a file, database, grid, string, or strongly-typed class. SaveTo<T> is the flagship overload - it automaps converted data directly into a typed C# class with zero mapping code.

WithInput

Sets the data source for the conversion. Accepts a file, database, grid, string, object, or dictionary list - GPAL infers the format or you can specify it explicitly with WithInputType.

WithInputType

Explicitly sets the format of the input data. Use when format cannot be auto-detected from a file extension or string content, or to override GPAL's detection.

WithOutputType

Sets the target format for the conversion. Determines how SaveTo, RenderTo, and AppendTo serialize the data.