From 1bcc5a50d991b65250f5bdc5b734fe2d0a119654 Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Thu, 9 Jan 2020 19:56:10 -0800 Subject: [PATCH 1/9] Change Json.NET to System.Text.Json --- xml/System.Web.Script.Serialization/JavaScriptSerializer.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml index dd627346597..430a2425770 100644 --- a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml +++ b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml @@ -16,7 +16,7 @@ - Json.NET should be used for serialization and deserialization. Provides serialization and deserialization functionality for AJAX-enabled applications. + The APIs in the namespace should be used for serialization and deserialization. Provides serialization and deserialization functionality for AJAX-enabled applications. Date: Tue, 24 Mar 2020 17:28:36 -0700 Subject: [PATCH 2/9] move serializer advice to remarks --- .../JavaScriptSerializer.xml | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml index 430a2425770..c47c569ff48 100644 --- a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml +++ b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml @@ -16,14 +16,18 @@ - The APIs in the namespace should be used for serialization and deserialization. Provides serialization and deserialization functionality for AJAX-enabled applications. + Provides serialization and deserialization functionality for AJAX-enabled applications. class is used internally by the asynchronous communication layer to serialize and deserialize the data that is passed between the browser and the Web server. You cannot access that instance of the serializer. However, this class exposes a public API. Therefore, you can use the class when you want to work with JavaScript Object Notation (JSON) in managed code. + +> [!IMPORTANT] +> For .NET Framewowrk 4.6.1 and later versions, the APIs in the namespace should be used for serialization and deserialization. For earlier versions of .NET Framework, use [Newtonsoft.Json](https://www.newtonsoft.com/json). + +The class is used internally by the asynchronous communication layer to serialize and deserialize the data that is passed between the browser and the Web server. You cannot access that instance of the serializer. However, this class exposes a public API. Therefore, you can use the class when you want to work with JavaScript Object Notation (JSON) in managed code. - To serialize an object, use the method. To deserialize a JSON string, use the or methods. To serialize and deserialize types that are not natively supported by , implement custom converters by using the class. Then register the converters by using the method. +To serialize an object, use the method. To deserialize a JSON string, use the or methods. To serialize and deserialize types that are not natively supported by , implement custom converters by using the class. Then register the converters by using the method. ## Mapping Between Managed Types and JSON The following table shows the mapping between managed types and JSON for the serialization process. These managed types are natively supported by . When you are deserializing from a JSON string to a managed type, the same mapping applies. However, deserialization can be asymmetric; not all serializable managed types can be deserialized from JSON. From 01bfb71aa29e497a5b91b45970617cec5152f534 Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Tue, 24 Mar 2020 17:29:37 -0700 Subject: [PATCH 3/9] fix indentation --- xml/System.Web.Script.Serialization/JavaScriptSerializer.xml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml index c47c569ff48..6327727f43f 100644 --- a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml +++ b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml @@ -16,7 +16,8 @@ - Provides serialization and deserialization functionality for AJAX-enabled applications. + Provides serialization and deserialization functionality for AJAX-enabled applications. + Date: Tue, 24 Mar 2020 17:30:14 -0700 Subject: [PATCH 4/9] fix typo --- xml/System.Web.Script.Serialization/JavaScriptSerializer.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml index 6327727f43f..cdccb9d6655 100644 --- a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml +++ b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml @@ -24,7 +24,7 @@ ## Remarks > [!IMPORTANT] -> For .NET Framewowrk 4.6.1 and later versions, the APIs in the namespace should be used for serialization and deserialization. For earlier versions of .NET Framework, use [Newtonsoft.Json](https://www.newtonsoft.com/json). +> For .NET Framework 4.6.1 and later versions, the APIs in the namespace should be used for serialization and deserialization. For earlier versions of .NET Framework, use [Newtonsoft.Json](https://www.newtonsoft.com/json). The class is used internally by the asynchronous communication layer to serialize and deserialize the data that is passed between the browser and the Web server. You cannot access that instance of the serializer. However, this class exposes a public API. Therefore, you can use the class when you want to work with JavaScript Object Notation (JSON) in managed code. From 5a47156a0c4df7a76257ccb534696e63c81695ff Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Tue, 24 Mar 2020 17:31:30 -0700 Subject: [PATCH 5/9] fix link --- xml/System.Web.Script.Serialization/JavaScriptSerializer.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml index cdccb9d6655..3eaae062c9d 100644 --- a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml +++ b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml @@ -24,7 +24,7 @@ ## Remarks > [!IMPORTANT] -> For .NET Framework 4.6.1 and later versions, the APIs in the namespace should be used for serialization and deserialization. For earlier versions of .NET Framework, use [Newtonsoft.Json](https://www.newtonsoft.com/json). +> For .NET Framework 4.6.1 and later versions, the APIs in the namespace should be used for serialization and deserialization. For earlier versions of .NET Framework, use [Newtonsoft.Json](https://www.newtonsoft.com/json). The class is used internally by the asynchronous communication layer to serialize and deserialize the data that is passed between the browser and the Web server. You cannot access that instance of the serializer. However, this class exposes a public API. Therefore, you can use the class when you want to work with JavaScript Object Notation (JSON) in managed code. From 5768f7089d9025fd87e2b704beb4b4c880bc1850 Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Wed, 25 Mar 2020 09:15:40 -0700 Subject: [PATCH 6/9] 4.6.1 --> 4.7.2 --- xml/System.Web.Script.Serialization/JavaScriptSerializer.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml index 3eaae062c9d..638778b0a46 100644 --- a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml +++ b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml @@ -24,7 +24,7 @@ ## Remarks > [!IMPORTANT] -> For .NET Framework 4.6.1 and later versions, the APIs in the namespace should be used for serialization and deserialization. For earlier versions of .NET Framework, use [Newtonsoft.Json](https://www.newtonsoft.com/json). +> For .NET Framework 4.7.2 and later versions, the APIs in the namespace should be used for serialization and deserialization. For earlier versions of .NET Framework, use [Newtonsoft.Json](https://www.newtonsoft.com/json). The class is used internally by the asynchronous communication layer to serialize and deserialize the data that is passed between the browser and the Web server. You cannot access that instance of the serializer. However, this class exposes a public API. Therefore, you can use the class when you want to work with JavaScript Object Notation (JSON) in managed code. From 5a1d08232db214285fa01472b89c15647c214f3f Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Wed, 25 Mar 2020 09:43:48 -0700 Subject: [PATCH 7/9] include use s.t.j/newtonsoft advice in summary --- xml/System.Web.Script.Serialization/JavaScriptSerializer.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml index 638778b0a46..3be13415a54 100644 --- a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml +++ b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml @@ -16,7 +16,7 @@ - Provides serialization and deserialization functionality for AJAX-enabled applications. + For .NET Framework 4.7.2 and later versions, use the APIs in the namespace for serialization and deserialization. For earlier veresions of .NET Framework, use Newtonsoft.Json. Date: Wed, 25 Mar 2020 09:44:36 -0700 Subject: [PATCH 8/9] fix typo --- xml/System.Web.Script.Serialization/JavaScriptSerializer.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml index 3be13415a54..ca1905e4a0e 100644 --- a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml +++ b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml @@ -16,7 +16,7 @@ - For .NET Framework 4.7.2 and later versions, use the APIs in the namespace for serialization and deserialization. For earlier veresions of .NET Framework, use Newtonsoft.Json. + For .NET Framework 4.7.2 and later versions, use the APIs in the namespace for serialization and deserialization. For earlier versions of .NET Framework, use Newtonsoft.Json. Date: Wed, 25 Mar 2020 13:43:35 -0700 Subject: [PATCH 9/9] Update xml/System.Web.Script.Serialization/JavaScriptSerializer.xml Co-Authored-By: Ahson Khan --- xml/System.Web.Script.Serialization/JavaScriptSerializer.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml index ca1905e4a0e..7e7aa077c67 100644 --- a/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml +++ b/xml/System.Web.Script.Serialization/JavaScriptSerializer.xml @@ -16,7 +16,7 @@ - For .NET Framework 4.7.2 and later versions, use the APIs in the namespace for serialization and deserialization. For earlier versions of .NET Framework, use Newtonsoft.Json. + For .NET Framework 4.7.2 and later versions, use the APIs in the namespace for serialization and deserialization. For earlier versions of .NET Framework, use Newtonsoft.Json. This type was intended to provide serialization and deserialization functionality for AJAX-enabled applications.