Primitives

Primitive types are parsed from string values in value nodes.

Supported types

Type	Allowed format examples
string	Literally any string.
char	Literally any single character.
bool	true, True, TRUE
byte, sbyte	Anything built-in TryParse method can grok.
short, ushort	Anything built-in TryParse method can grok.
int, uint	Anything built-in TryParse method can grok.
long, ulong	Anything built-in TryParse method can grok.
float, double, decimal	1.23, 1,23, 5,12e2
Guid	Anything built-in TryParse method can grok.
Uri	http://example.com, example.com/some, /part/of/path
TimeSpan	00:12:34, 2 seconds, 500 ms, 1.5 days, 10s, 0.5 minutes
DateTime(Offset)	2018-03-14 15:09:26.535, 20050809T181142+0330
IPAddress	127.0.0.1, 2001:0db8:11a3:09d7:1f34:8a2e:07a0:765d
IPEndPoint	192.168.1.10:80
DataSize	453453 (just bytes), 1 kb, 24.3 megabytes, 500 TB
DataRate	500 (just bytes/sec), 200 kilobytes/second, 5 GB/sec, 80 mb/s
Encoding	utf-8, us-ascii
Enum types	Anything built-in TryParse method can grok.
Nullable structs	A valid value or null.

DataSize and DataRate are custom new types. They also provide factory extensions and operators:

DataSize size = 50.Megabytes();
DataRate rate = size / 2.Seconds();

Parse method convention

There's also support for types that implement Parse or TryParse method with standard signature:

class/struct T 
{
    public static T Parse(string input) { ... }
    
    public static bool TryParse(string input, out T result) { ... }
}

This allows to use arbitrary types with string representation without resorting to implementation of custom binders.

Node requirements

Value node or a container (array/object) node with a single value node child.

Null node handling

Default value for the type is used unless explictly required.

Explicitly specified null string value has the same effect.

Incorrect format handling

Parsing errors arising from incorrect value formats lead to binder failure and result in exceptions, even for optional members (see classes and structs for more context).

Related pages

Binding nodes to models