Skip to content

Commit eafbee0

Browse files
authored
JSON Serialization docs (#14208)
1 parent 3ae26a9 commit eafbee0

File tree

4 files changed

+826
-44
lines changed

4 files changed

+826
-44
lines changed
Lines changed: 15 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,35 @@
11
---
2-
title: "Serialization in .NET"
3-
ms.date: "03/30/2017"
2+
title: "Serialization - .NET"
3+
ms.date: "09/02/2019"
44
helpviewer_keywords:
5+
- "JSON serialization"
56
- "XML serialization, defined"
67
- "binary serialization"
78
- "serializing objects"
89
- "serialization"
910
- "objects, serializing"
1011
ms.assetid: 4d1111c0-9447-4231-a997-96a2b74b3453
1112
---
13+
1214
# Serialization in .NET
13-
Serialization is the process of converting the state of an object into a form that can be persisted or transported. The complement of serialization is deserialization, which converts a stream into an object. Together, these processes allow data to be easily stored and transferred.
14-
15-
.NET features two serialization technologies:
15+
16+
Serialization is the process of converting the state of an object into a form that can be persisted or transported. The complement of serialization is deserialization, which converts a stream into an object. Together, these processes allow data to be stored and transferred.
1617

17-
- Binary serialization preserves type fidelity, which is useful for preserving the state of an object between different invocations of an application. For example, you can share an object between different applications by serializing it to the Clipboard. You can serialize an object to a stream, to a disk, to memory, over the network, and so forth. Remoting uses serialization to pass objects "by value" from one computer or application domain to another.
18+
.NET features the following serialization technologies:
1819

19-
- XML serialization serializes only public properties and fields and does not preserve type fidelity. This is useful when you want to provide or consume data without restricting the application that uses the data. Because XML is an open standard, it is an attractive choice for sharing data across the Web. SOAP is likewise an open standard, which makes it an attractive choice.
20+
- [Binary serialization](binary-serialization.md) preserves type fidelity, which is useful for preserving the state of an object between different invocations of an application. For example, you can share an object between different applications by serializing it to the Clipboard. You can serialize an object to a stream, to a disk, to memory, over the network, and so forth. Remoting uses serialization to pass objects "by value" from one computer or application domain to another.
2021

21-
## In This Section
22-
[Serialization How-to Topics](../../../docs/standard/serialization/serialization-how-to-topics.md)
23-
Lists links to How-to topics contained in this section.
22+
- [XML and SOAP serialization](xml-and-soap-serialization.md) serializes only public properties and fields and does not preserve type fidelity. This is useful when you want to provide or consume data without restricting the application that uses the data. Because XML is an open standard, it is an attractive choice for sharing data across the Web. SOAP is likewise an open standard, which makes it an attractive choice.
2423

25-
[Binary Serialization](../../../docs/standard/serialization/binary-serialization.md)
26-
Describes the binary serialization mechanism that is included with the common language runtime.
27-
28-
[XML and SOAP Serialization](../../../docs/standard/serialization/xml-and-soap-serialization.md)
29-
Describes the XML and SOAP serialization mechanism that is included with the common language runtime.
30-
31-
[Serialization Tools](../../../docs/standard/serialization/serialization-tools.md)
32-
These tools help develop serialization code.
33-
34-
[Serialization Samples](../../../docs/standard/serialization/serialization-samples.md)
35-
The samples demonstrate how to do serialization.
24+
- [JSON serialization](system-text-json-overview.md) serializes only public properties and does not preserve type fidelity. JSON is an open standard that is an attractive choice for sharing data across the web.
3625

3726
## Reference
38-
<xref:System.Runtime.Serialization>
27+
28+
<xref:System.Runtime.Serialization>
3929
Contains classes that can be used for serializing and deserializing objects.
4030

4131
<xref:System.Xml.Serialization>
4232
Contains classes that can be used to serialize objects into XML format documents or streams.
33+
34+
<xref:System.Text.Json>
35+
Contains classes that can be used to serialize objects into JSON format documents or streams.

0 commit comments

Comments
 (0)