Schema.NET

Schema.org objects turned into strongly typed C# POCO classes for use in .NET. All classes can be serialized into JSON/JSON-LD and XML, typically used to represent structured data in the head section of html page.

Simple Example

var website = new WebSite()
{
    AlternateName = "An Alternative Name",
    Name = "Your Site Name",
    Url = new Uri("https://example.com")
};
var jsonLd = website.ToString();

The code above outputs the following JSON-LD:

{
    "@context":"https://schema.org",
    "@type":"WebSite",
    "alternateName":"An Alternative Name",
    "name":"Your Site Name",
    "url":"https://example.com"
}

If writing the result into a `

##### Important Security Notice
When serializing the result for a website's `

Windows UWP Sharing

Windows UWP apps let you share data using schema.org classes. Here is an example showing how to share metadata about a book.

Classes & Properties

schema.org defines classes and properties, where each property can have a single value or an array of multiple values. Additionally, properties can have multiple types e.g. an Address property could have a type of string or a type of PostalAddress which has it's own properties such as StreetAddress or PostalCode which breaks up an address into it's constituent parts.

To facilitate this Schema.NET uses some clever C# generics and implicit type conversions so that setting a single or multiple values is possible and that setting a string or PostalAddress is also possible:

…

This magic is all carried out using implicit conversion operators in the OneOrMany, Values, Values and Values types. These types are all structs for best performance too.

More Examples

For more examples and actual running code samples, take a look at the unit tests in the project source code.

Schema.NET.Pending

There are many pending types on schema.org which are not yet fully formed and ready for production. If you need to use these, you can install the Schema.NET.Pending NuGet package instead of Schema.NET. This package contains all released schema types as well as all pending types.

Continuous Integration

Contributions and Thanks

Please view the contributing guide for more information.

• kirkone - CI reads .NET Core version from new global.json file.
• Turnerj - Added System.Text.Json support, Had all types implement IEquatable GetHashCode and added extra unit tests and bug fixes.
• shervinw - Added better null value handling for structs.
• kirk-marple - Refactoring JSON serialization to be more efficient.
• nickevansuk - Adding better null value handling and use HTTPS instead of HTTP.
• MEmanuelsson - Added support for the schema.org Date type without time.
• halovanic - For adding interfaces to Schema.NET types for greater flexibility.
• AndreSteenbergen - For enabling the tool to work on linux.
• benmccallum - For adding XSS vlnerability protection.
• psampaio - Added deserialization support and unit tests.
• icunningham88 - Improved a test.