-Documentation

2015-02-16 23:31:52 +13:00
parent 7c57b1663c
commit f132b87eaa
31 changed files with 1231 additions and 14 deletions
@@ -0,0 +1,77 @@
+#region License
+// Copyright (c) 2007 James Newton-King
+//
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+//
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+#endregion
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using NUnit.Framework;
+using System.Runtime.Serialization;
+using Newtonsoft.Json.Linq;
+
+namespace Newtonsoft.Json.Tests.Documentation.Samples.Serializer
+{
+    [TestFixture]
+    public class SerializeExtensionData : TestFixtureBase
+    {
+        #region Types
+        public class CustomerInvoice
+        {
+            // we're only modifing the tax rate
+            public decimal TaxRate { get; set; }
+
+            // everything else gets stored here
+            [JsonExtensionData]
+            private IDictionary<string, JToken> _additionalData;
+        }
+        #endregion
+
+        [Test]
+        public void Example()
+        {
+            #region Usage
+            string json = @"{
+              'HourlyRate': 150,
+              'Hours': 40,
+              'TaxRate': 0.125
+            }";
+
+            CustomerInvoice invoice = JsonConvert.DeserializeObject<CustomerInvoice>(json);
+
+            // increase tax to 15%
+            invoice.TaxRate = 0.15m;
+
+            string result = JsonConvert.SerializeObject(invoice);
+            // {
+            //   "TaxRate": 0.15,
+            //   "HourlyRate": 150,
+            //   "Hours": 40
+            // }
+            #endregion
+
+            Assert.AreEqual(@"{""TaxRate"":0.15,""HourlyRate"":150,""Hours"":40}", result);
+        }
+    }
+}