DataContractJsonSerializer 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将对象序列化为 JavaScript 对象表示法（JSON），并将 JSON 数据反序列化为对象。 此类不能被继承。
public ref class DataContractJsonSerializer sealedpublic ref class DataContractJsonSerializer sealed : System::Runtime::Serialization::XmlObjectSerializerpublic sealed class DataContractJsonSerializerpublic sealed class DataContractJsonSerializer : System.Runtime.Serialization.XmlObjectSerializertype DataContractJsonSerializer = classtype DataContractJsonSerializer = class
inherit XmlObjectSerializerPublic NotInheritable Class DataContractJsonSerializerPublic NotInheritable Class DataContractJsonSerializer
Inherits XmlObjectSerializer- 继承
-
DataContractJsonSerializer
- 继承
注解
对于涉及序列化为 JSON 并从 JSON 反序列化的大多数方案，我们建议 在 System.Text.Json 命名空间中使用 API。
如果你的方案需要类 DataContractJsonSerializer ，则可以使用它将类型的实例序列化为 JSON 文档，并将 JSON 文档反序列化为类型的实例。 例如，可以创建一个包含基本数据（例如名称和地址）的属性命名 Person 的类型。 然后，可以在 JSON 文档中创建和操作类的 Person 实例并写入其所有属性值，以供以后检索。 稍后可将此 JSON 文档反序列化为具有等效数据协定的 Person 类或其他类。
如果在服务器上序列化传出回复期间发生错误，或者回复操作出于其他原因引发异常，则可能无法将错误返回给客户端。
构造函数
属性
| 名称 | 说明 |
|---|---|
| DataContractSurrogate |
获取当前为给定 IDataContractSurrogate 实例处于活动状态的代理项类型。 代理项可以扩展序列化或反序列化过程。 |
| DateTimeFormat |
获取对象图中的日期和时间类型项的格式。 |
| EmitTypeInformation |
获取或设置用于发出类型信息的数据协定 JSON 序列化程序设置。 |
| IgnoreExtensionDataObject |
获取一个值，该值指定是否在反序列化时忽略未知数据，以及 IExtensibleDataObject 是否在序列化时忽略接口。 |
| KnownTypes |
获取一个类型集合，这些类型可能存在于使用此实例 DataContractJsonSerializer序列化的对象图中。 |
| MaxItemsInObjectGraph |
获取序列化程序在一次读取或写入调用中序列化或反序列化的对象图中的最大项数。 |
| SerializeReadOnlyTypes |
获取或设置一个值，该值指定是否序列化只读类型。 |
| UseSimpleDictionaryFormat |
获取一个值，该值指定是否使用简单的字典格式。 |
方法
| 名称 | 说明 |
|---|---|
| Equals(Object) |
确定指定的对象是否等于当前对象。 (继承自 Object) |
| GetHashCode() |
用作默认哈希函数。 (继承自 Object) |
| GetType() |
获取当前实例的 Type。 (继承自 Object) |
| IsStartObject(XmlDictionaryReader) |
获取一个值，该值指定是否 XmlDictionaryReader 定位在表示序列化程序可从中反序列化的对象的 XML 元素上。 |
| IsStartObject(XmlReader) |
确定该对象是否 XmlReader 位于可反序列化的对象上。 |
| MemberwiseClone() |
创建当前 Object的浅表副本。 (继承自 Object) |
| ReadObject(Stream) |
以 JSON（JavaScript 对象表示法）格式读取文档流并返回反序列化的对象。 |
| ReadObject(XmlDictionaryReader, Boolean) |
读取使用 JSON 映射并 XmlDictionaryReader 返回反序列化对象的 XML 文档;它还使你能够指定序列化程序是否应在尝试反序列化之前验证它是否位于适当的元素上。 |
| ReadObject(XmlDictionaryReader) |
使用 JSON（JavaScript 对象表示法） XmlDictionaryReader 读取映射的 XML 文档，并返回反序列化的对象。 |
| ReadObject(XmlReader, Boolean) |
读取从 JSON 映射并 XmlReader 返回反序列化对象的 XML 文档;它还使你能够指定序列化程序是否应在尝试反序列化之前验证它是否位于适当的元素上。 |
| ReadObject(XmlReader) |
使用 JSON（JavaScript 对象表示法） XmlReader 读取映射的 XML 文档，并返回反序列化的对象。 |
| ToString() |
返回一个表示当前对象的字符串。 (继承自 Object) |
| WriteEndObject(XmlDictionaryWriter) |
使用 XmlDictionaryWriter可映射到 JavaScript 对象表示法（JSON）的 XML 文档将结束 XML 元素写入 XML 文档。 |
| WriteEndObject(XmlWriter) |
使用 XmlWriter可映射到 JavaScript 对象表示法（JSON）的 XML 文档将结束 XML 元素写入 XML 文档。 |
| WriteObject(Stream, Object) |
将指定的对象序列化为 JavaScript 对象表示法（JSON）数据，并将生成的 JSON 写入流。 |
| WriteObject(XmlDictionaryWriter, Object) |
将对象序列化为可以映射到 JavaScript 对象表示法（JSON）的 XML。 使用 a XmlDictionaryWriter. 写入所有对象数据，包括起始 XML 元素、内容和结束元素。 |
| WriteObject(XmlWriter, Object) |
将对象序列化为可以映射到 JavaScript 对象表示法（JSON）的 XML。 使用 a XmlWriter. 写入所有对象数据，包括起始 XML 元素、内容和结束元素。 |
| WriteObjectContent(XmlDictionaryWriter, Object) |
使用 .. 写入可映射到 JavaScript 对象表示法（JSON） XmlDictionaryWriter的 XML 内容。 |
| WriteObjectContent(XmlWriter, Object) |
使用 .. 写入可映射到 JavaScript 对象表示法（JSON） XmlWriter的 XML 内容。 |
| WriteStartObject(XmlDictionaryWriter, Object) |
编写用于将对象序列化为 XML 的打开的 XML 元素，该对象可以使用 |
| WriteStartObject(XmlWriter, Object) |
编写用于将对象序列化为 XML 的打开的 XML 元素，该对象可以使用 |