47 lines
2.3 KiB
XML
47 lines
2.3 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<topic id="CreatingLINQtoJSON" revisionNumber="1">
|
|
<developerConceptualDocument xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<introduction>
|
|
<para>As well as parsing JSON from existing JSON strings, LINQ to JSON objects can be created from scratch to create new JSON structures.</para>
|
|
<autoOutline lead="none" excludeRelatedTopics="true" />
|
|
</introduction>
|
|
|
|
<section address="CreatingManually">
|
|
<title>Manually Creating JSON</title>
|
|
<content>
|
|
<para>Setting values and creating objects and arrays one at a time gives you
|
|
total control, but it is more verbose than other options.</para>
|
|
|
|
<code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\LinqToJsonTests.cs" region="LinqToJsonCreateNormal" title="Creating JSON" />
|
|
</content>
|
|
</section>
|
|
|
|
<section address="CreatingLINQ">
|
|
<title>Creating JSON with LINQ</title>
|
|
<content>
|
|
<para>Declaratively creating JSON objects using LINQ is a fast way to create JSON from collections of values.</para>
|
|
|
|
<code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\LinqToJsonTests.cs" region="LinqToJsonCreateDeclaratively" title="Creating JSON Declaratively" />
|
|
</content>
|
|
</section>
|
|
|
|
<section address="CreatingFromObject">
|
|
<title>Creating JSON from an object</title>
|
|
<content>
|
|
<para>The last option is to create a JSON object from a non-JSON type using the
|
|
<codeEntityReference>Overload:Newtonsoft.Json.Linq.JObject.FromObject</codeEntityReference>
|
|
method. Internally, FromObject will use the JsonSerializer to serialize the object to LINQ to JSON objects instead of text.</para>
|
|
|
|
<para>The example below shows creating a JSON object from an anonymous object, but any
|
|
.NET type can be used with FromObject to create JSON.</para>
|
|
|
|
<code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\LinqToJsonTests.cs" region="LinqToJsonCreateFromObject" title="Creating JSON from an Object" />
|
|
</content>
|
|
</section>
|
|
<relatedTopics>
|
|
<link xlink:href="LINQtoJSON" />
|
|
|
|
<codeEntityReference>Overload:Newtonsoft.Json.Linq.JObject.FromObject</codeEntityReference>
|
|
</relatedTopics>
|
|
</developerConceptualDocument>
|
|
</topic> |