All files
[pithos-ms-client] / trunk / Libraries / Json40r2 / Source / Doc / Introduction.html
1 <html>
2 <head>
3     <title>Introduction</title>
4     <link href="styles.css" rel="stylesheet" type="text/css" />
5     <link href="custom.css" rel="stylesheet" type="text/css" />
6 </head>
7 <body>
8     <div id="control">
9         <span class="productTitle">Json.NET - Quick Starts & API Documentation</span><br />
10         <span class="topicTitle">Introduction</span></div>
11     <div id="content">
12         <span style="color: DarkGray"></span>
13         <p>
14             Json.NET makes working with JSON formatted data in .NET
15             simple. Quickly read and write JSON using LINQ to JSON or serialize
16             your .NET objects with a single method call using the JsonSerializer.</p>
17         <h3>
18             Features</h3>
19         <ul>
20             <li>Flexible JSON serializer to convert .NET objects to JSON and back again</li>
21             <li>LINQ to JSON for reading and writing JSON</li>
22             <li>Writes indented, easy to read JSON</li>
23             <li>Convert JSON to and from XML</li>
24             <li>Supports Silverlight and the Compact Framework</li>
25         </ul>
26         <p>The JSON serializer is a good choice when the JSON you are reading or writing maps closely
27         to a .NET class. The serializer automatically reads and writes JSON for the class.</p>
28         <p class="MsoNormal">
29             For situations where you are only interested in getting values from JSON, don&#39;t 
30             have a class to serialize or deserialize to, or the JSON is radically different 
31             from your class and you need to manually read and write from your objects then 
32             LINQ to JSON is what you should use. LINQ to JSON allows you to easily read, 
33             create and modify JSON in .NET.</p>
34         <h3>
35             History</h3>
36         <p>
37             Json.NET grew out of projects I was working on in late 2005 involving JavaScript,
38             AJAX and .NET. At the time there were no libraries for working with JavaScript in
39             .NET so I began to grow my own.</p>
40         <p>
41             Starting out as a couple of static methods for escaping JavaScript strings, Json.NET
42             evolved as features were added. To add support for reading JSON a major refactor
43             was required and Json.NET will split into the three major classes it still uses
44             today, JsonReader, JsonWriter and JsonSerializer.
45         </p>
46         <p>
47             Json.NET was first released in June 2006. Since then Json.NET has been downloaded
48             thousands of times by developers and is used in a number of major projects open
49             source projects including <a href="http://www.castleproject.org/monorail/index.html" target="_blank">MonoRail</a>,
50             Castle Project's MVC web framework, and <a href="http://www.mono-project.com/" target="_blank">Mono</a>,
51             an open source implementation
52             of the .NET framework.</p>
53         <p>
54             <i>~ James Newton-King</i></p>
55         <h3>
56             Donate</h3>
57         <p>
58             Json.NET is a free open source project that I have developed in my personal time.</p>
59             <p>
60             I really appreciate your feedback and support for Json.NET and its future development.</p>
61         <p><a 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" target="_blank">
62             <img src="donate.gif" alt="Donate" style="border-width:0;" />
63             </a></p>
64         <div id="footer">
65         </div>
66     </div>
67 </body>
68 </html>