James Newton-King
d9c8d78d77
-Added support for DataMemberAttribute's EmitDefaultValue -Fixed losing decimal precision when writing JValues -Fixed error when calling ToList on empty JObjects and JArrays
133 lines
5.3 KiB
XML
133 lines
5.3 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<topic id="Introduction" revisionNumber="1">
|
|
<developerConceptualDocument xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<!--
|
|
<summary>
|
|
<para>Optional summary abstract</para>
|
|
</summary>
|
|
-->
|
|
<introduction>
|
|
<para>Json.NET is a popular high-performance JSON framework for .NET</para>
|
|
</introduction>
|
|
<!-- Optional procedures followed by optional code example but must have
|
|
at least one procedure or code example -->
|
|
<section>
|
|
<title>Benefits and Features</title>
|
|
<content>
|
|
<list class="bullet">
|
|
<listItem>
|
|
<para>Flexible JSON serializer for converting between .NET objects and JSON</para>
|
|
</listItem>
|
|
<listItem>
|
|
<para>LINQ to JSON for manually reading and writing JSON </para>
|
|
</listItem>
|
|
<listItem>
|
|
<para>High performance, faster than .NET's built-in JSON serializers</para>
|
|
</listItem>
|
|
<listItem>
|
|
<para>Write indented, easy to read JSON</para>
|
|
</listItem>
|
|
<listItem>
|
|
<para>Convert JSON to and from XML</para>
|
|
</listItem>
|
|
<listItem>
|
|
<para>Supports .NET 2, .NET 3.5, .NET 4, .NET 4.5, Silverlight, Windows Phone and Windows 8 RT</para>
|
|
</listItem>
|
|
|
|
</list>
|
|
<para>The JSON serializer in Json.NET is a good choice when the JSON you are reading or writing maps closely to a .NET class.</para>
|
|
<para>LINQ to JSON is good for situations where you are only interested in
|
|
getting values from JSON, you don't have a class to serialize or deserialize to,
|
|
or the JSON is radically different from your class and you need to manually read
|
|
and write from your objects.</para>
|
|
</content>
|
|
</section>
|
|
|
|
<section>
|
|
<title>Getting Started</title>
|
|
<content>
|
|
|
|
<list class="bullet">
|
|
<listItem><para><externalLink>
|
|
<linkText>Serializing and Deserializing JSON</linkText>
|
|
<linkUri>SerializingJSON.htm</linkUri>
|
|
<linkTarget>_self</linkTarget>
|
|
</externalLink></para></listItem>
|
|
<listItem><para><externalLink>
|
|
<linkText>LINQ to JSON</linkText>
|
|
<linkUri>LINQtoJSON.htm</linkUri>
|
|
<linkTarget>_self</linkTarget>
|
|
</externalLink></para></listItem>
|
|
</list>
|
|
|
|
</content>
|
|
</section>
|
|
<section>
|
|
<title>History</title>
|
|
<content><para>Json.NET grew out of projects I was working on in late 2005 involving JavaScript,
|
|
AJAX and .NET. At the time there were no libraries for working with JavaScript in
|
|
.NET so I made my own.</para>
|
|
<para>Starting out as a couple of static methods for escaping JavaScript strings, Json.NET
|
|
evolved as features were added. To add support for reading JSON a major refactor
|
|
was required and Json.NET will split into the three major classes it still uses
|
|
today, JsonReader, JsonWriter and JsonSerializer.</para>
|
|
<para>Json.NET was first released in June 2006. Since then Json.NET has been downloaded
|
|
hundreds of thousands of times by developers around the world. It is used in many major open
|
|
source projects including <externalLink>
|
|
<linkText>Mono</linkText>
|
|
<linkUri>http://www.mono-project.com/</linkUri>
|
|
<linkTarget>_blank</linkTarget>
|
|
</externalLink>,
|
|
an open source implementation
|
|
of the .NET framework; <externalLink>
|
|
<linkText>RavenDB</linkText>
|
|
<linkUri>http://ravendb.net/</linkUri>
|
|
<linkTarget>_blank</linkTarget>
|
|
</externalLink>,
|
|
a JSON based documentat database; <externalLink>
|
|
<linkText>SignalR</linkText>
|
|
<linkUri>http://signalr.net/</linkUri>
|
|
<linkTarget>_blank</linkTarget>
|
|
</externalLink>,
|
|
an async library for building real-time, multi-user interactive web applications; and <externalLink>
|
|
<linkText>ASP.NET Web API</linkText>
|
|
<linkUri>http://www.asp.net/web-api</linkUri>
|
|
<linkTarget>_blank</linkTarget>
|
|
</externalLink>,
|
|
Microsoft's HTTP service framework.</para>
|
|
<para><externalLink>
|
|
<linkText>James Newton-King</linkText>
|
|
<linkUri>http://twitter.com/jamesnk</linkUri>
|
|
<linkTarget>_blank</linkTarget>
|
|
</externalLink></para>
|
|
</content>
|
|
</section>
|
|
|
|
<section>
|
|
<title>Donate</title>
|
|
<content><para>Json.NET is a free open source project developed in my own time.</para>
|
|
<para>I really appreciate your feedback and donations help support Json.NET and its future development.</para></content>
|
|
</section>
|
|
|
|
<markup>
|
|
<p>
|
|
<a target="_blank" href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=james%40newtonking%2ecom&item_name=Supporting%20Json%2eNET&no_shipping=0&no_note=1&tax=0&currency_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8">
|
|
<img style="border-width:0;" alt="Donate" src="../donate.gif" />
|
|
</a>
|
|
</p>
|
|
</markup>
|
|
<relatedTopics>
|
|
<externalLink>
|
|
<linkText>Serializing and Deserializing JSON</linkText>
|
|
<linkUri>SerializingJSON.htm</linkUri>
|
|
<linkTarget>_self</linkTarget>
|
|
</externalLink>
|
|
<externalLink>
|
|
<linkText>LINQ to JSON</linkText>
|
|
<linkUri>LINQtoJSON.htm</linkUri>
|
|
<linkTarget>_self</linkTarget>
|
|
</externalLink>
|
|
</relatedTopics>
|
|
|
|
</developerConceptualDocument>
|
|
</topic> |