JSON(JavaScript 对象表示法)是专门为浏览器中的网页上运行的 JavaScript 代码而设计的一种数据格式。 它是 ASP.NET AJAX 服务创建 Windows Communication Foundation (WCF) 中使用的默认数据格式。
在未与 ASP.NET 集成的情况下(在此情况下,XML 将是默认格式,但可以选择 JSON)创建 AJAX 服务时,也可以使用此格式。
最后,如果需要 JSON 支持但不创建 AJAX 服务,则可以使用 xref:System.Runtime.Serialization.Json.DataContractJsonSerializer,以便将 .NET 对象直接序列化为 JSON 数据并将此类数据反序列化回 .NET 类型的实例。 有关如何执行此操作的说明,请参阅如何:序列化和反序列化 JSON 数据。
使用 JSON 时,它支持的 .NET 类型与 xref:System.Runtime.Serialization.DataContractSerializer 支持的类型相同,但有少数例外。 有关支持的类型的列表,请参阅类型支持的数据协定序列化程序。 支持的类型包括大多数基元类型、大多数数组和集合类型,以及使用 xref:System.Runtime.Serialization.DataContractAttribute 和 xref:System.Runtime.Serialization.DataMemberAttribute 的复杂类型。
将 .NET 类型映射到 JSON 类型
下表显示 .NET 类型和 JSON/JavaScript 类型在通过序列化和反序列化过程进行映射时的对应关系。
| .NET 类型 | JSON/JavaScript | 说明 |
|---|---|---|
| 所有数值类型,例如 xref:System.Int32、xref:System.Decimal 或 xref:System.Double | 数字 | 不支持 Double.NaN、Double.PositiveInfinity 和 Double.NegativeInfinity 等特殊值,它们会导致无效的 JSON。 |
| xref:System.Enum | 数字 | 请参见本主题中后面的“枚举和 JSON”。 |
| xref:System.Boolean | Boolean | -- |
| xref:System.String, xref:System.Char | String | -- |
| xref:System.TimeSpan, xref:System.Guid, xref:System.Uri | String | 在 JSON 中这些类型的格式是与 XML 中的相同 (实质上,采用 ISO 8601 持续时间格式的时间跨度,采用"12345678-ABCD-ABCD-ABCD-1234567890AB"格式的 GUID 和其自然字符串形式的 URI,如" http://www.example.com ")。 精确的信息,请参阅数据协定架构参考。 |
| xref:System.Xml.XmlQualifiedName | String | 格式为“名称:命名空间”(第一个冒号之前的所有内容都是名称)。 可以缺少名称或命名空间。 如果没有命名空间,则也可以省略冒号。 |
| xref:System.Array 类型的 xref:System.Byte | 数字数组 | 每个数字都表示一个字节的值。 |
| xref:System.DateTime | DateTime 或 String | 请参见本主题中后面的“日期/时间和 JSON”。 |
| xref:System.DateTimeOffset | 复杂类型 | 请参见本主题中后面的“日期/时间和 JSON”。 |
| XML 和 ADO.NET 类型(xref:System.Xml.XmlElement、 xref:System.Xml.Linq.XElement。 xref:System.Xml.XmlNode、 xref:System.Runtime.Serialization.ISerializable, xref:System.Data.DataSet)格式模式中出现的位置生成。 | String | 请参见本主题的“XML 类型和 JSON”一节。 |
| xref:System.DBNull | 空复杂类型 | -- |
| 集合、字典和数组 | 数组 | 请参见本主题的“集合、字典和数组”一节。 |
| 复杂类型(应用了 xref:System.Runtime.Serialization.DataContractAttribute 或 xref:System.SerializableAttribute) | 复杂类型 | 数据成员变为 JavaScript 复杂类型的成员。 |
| 实现 xref:System.Runtime.Serialization.ISerializable 接口的复杂类型 | 复杂类型 | 与其他复杂类型相同,但不支持某些 xref:System.Runtime.Serialization.ISerializable 类型(请参见本主题“高级信息”一节的“ISerializable 支持”部分)。 |
任何类型的 Null 值 |
null | 也支持可以为 null 的类型,这些类型映射到 JSON 的方式与不可以为 null 的类型相同。 |
枚举和 JSON
在 JSON 中,枚举成员值被作为数字处理,这与数据协定中处理枚举成员值的方式不同。在数据协定中,枚举成员值被视为成员名称。 有关数据协定处理方式的详细信息,请参阅中的数据协定的枚举类型。
-
例如,如果存在
public enum Color {red, green, blue, yellow, pink},则序列化yellow将生成数字 3,而不是字符串“yellow”。 -
所有
enum成员都是可序列化的。 如果使用了 xref:System.Runtime.Serialization.EnumMemberAttribute 和 xref:System.NonSerializedAttribute 属性,则忽略它们。 -
可以反序列化不存在的
enum值。例如,可以将值 87 反序列化为上面的颜色枚举,尽管并未定义相应的颜色名称。 -
标志
enum并不特殊,其处理方式与任何其他enum相同。
日期/时间和 JSON
JSON 格式不直接支持日期和时间。 但是,由于这些类型十分常用,因此 ASP.NET AJAX 对它们提供了特殊的支持。 使用 ASP.NET AJAX 代理时,.NET 中的 xref:System.DateTime 类型与 JavaScript 中的 DateTime 类型完全对应。
-
当不使用 ASP.NET 时,xref:System.DateTime 类型在 JSON 中将表示为一个具有特殊格式的字符串。本主题的“高级信息”一节中对这种特殊格式进行了描述。
-
xref:System.DateTimeOffset 在 JSON 中以复杂类型表示:{"DateTime":dateTime,"OffsetMinutes":offsetMinutes}。
offsetMinutes成员是与相关事件所在位置关联的本地时间与格林威治标准时间 (GMT)(现在也称为协调世界时 (UTC))之间的偏移量。dateTime成员表示发生相关事件时的时间实例(同样,当使用 ASP.NET AJAX 时,它将变为 JavaScript 中的DateTime;不使用 ASP.NET AJAX 时,它将变为字符串)。dateTime成员始终用 GMT 格式进行序列化。 因此,如果描述纽约时间凌晨 3:00,dateTime的时间部分将是上午 8:00,而offsetMinutes是 300(从 GMT 中减去 300 分钟或 5 个小时)。NOTE 在将 xref:System.DateTime 和 xref:System.DateTimeOffset 对象序列化为 JSON 时,它们保留的信息精度仅为毫秒。 在序列化期间,次于毫秒的值(微秒/毫微秒)将丢失。
XML 类型和 JSON
XML 类型成为 JSON 字符串。
-
例如,如果 XElement 类型的数据成员"q"包含<abc / >,JSON 是 {"q":"<abc / >"}。
-
有一些特殊的规则来指定如何包装 XML。有关更多信息,请参见本主题后面的“高级信息”一节。
-
使用 ASP.NET AJAX 时,如果不希望使用 JavaScript 中的字符串,而是想改用 XML DOM,请在 xref:System.ServiceModel.Web.WebGetAttribute.ResponseFormat* 上将 xref:System.ServiceModel.Web.WebGetAttribute 属性设置为 XML,或者在 xref:System.ServiceModel.Web.WebInvokeAttribute.ResponseFormat* 上将 xref:System.ServiceModel.Web.WebInvokeAttribute 属性设置为 XML。
集合、字典和数组
在 JSON 中,所有的集合、字典和数组都表示为数组。
-
在 JSON 表示中,忽略使用 xref:System.Runtime.Serialization.CollectionDataContractAttribute 的任何自定义。
-
词典不能直接用于 JSON。 字典<字符串、 对象 > 所期望的与其他 JSON 技术可能不在 WCF 中相同的方式支持。 例如,在字典中,如果“abc”映射到“xyz”,且“def”映射到 42,则 JSON 表示形式不是 {"abc":"xyz","def":42},而是 [{"Key":"abc","Value":"xyz"},{"Key":"def","Value":42}]。
-
如果想要直接使用 JSON(动态访问键和值,而不预定义严格的协定),您有下面几个选择:
-
请考虑使用弱类型 JSON 序列化 (AJAX)示例。
-
请考虑使用 xref:System.Runtime.Serialization.ISerializable 接口和反序列化构造函数。这两个机制允许分别访问序列化和反序列化时的 JSON 键/值对,但不能用于部分受信任的方案。
-
请考虑使用Mapping Between JSON and XML而不是使用序列化程序。
-
多态性序列化的上下文中是指序列化派生的类型应是其基类型的能力。 在以多态形式使用集合时(例如,在将集合分配给 xref:System.Object 时),有一些 JSON 特定的特殊规则。 有关此问题的更多详细讨论,请参见本主题后面的“高级信息”一节。
-
其他详细信息
数据成员的顺序
使用 JSON 时数据成员的顺序并不重要。 具体而言,即使设置了 xref:System.Runtime.Serialization.DataMemberAttribute.Order*,也仍然可以按任意顺序反序列化 JSON 数据。
JSON 类型
JSON 类型在反序列化时并不一定要与上面的表匹配。 例如,Int 通常映射到 JSON 数字,但只要 JSON 字符串中包含有效的数字,就可以成功地从该字符串反序列化到此类型。 即,如果存在名为“q”的 Int 数据成员,则 {"q":42} 和 {"q":"42"} 都是有效的。
多态性
多态序列化具备在需要基类型时序列化派生类型的能力。 这是由 WCF 相当于支持 XML 序列化的方式支持 JSON 序列化。 例如,可以序列化为MyDerivedType其中MyBaseType预期行为,或进行序列化Int其中Object预期。
需要基类型时,反序列化派生类型可能会丢失类型信息,除非反序列化复杂类型。 例如,如果在需要 xref:System.Uri 时序列化 xref:System.Object,将导致一个 JSON 字符串。 如果随后将此字符串反序列化回 xref:System.Object,将返回一个 .NET xref:System.String。 反序列化程序并不知道该字符串最初属于 xref:System.Uri 类型。 通常情况下,在需要 xref:System.Object 时,所有的 JSON 字符串都将反序列化为 .NET 字符串,并且用于序列化 .NET 集合、字典和数组的所有 JSON 数组都将反序列化为 xref:System.Array 类型的 .NET xref:System.Object,而不考虑实际的原始类型。 JSON 布尔值映射到 .NET xref:System.Boolean。 但是,在需要 xref:System.Object 时,JSON 数字将反序列化为 .NET xref:System.Int32、xref:System.Decimal 或 xref:System.Double,将根据具体情况自动选择最适合的类型。
反序列化为接口类型时,xref:System.Runtime.Serialization.Json.DataContractJsonSerializer 会将声明的类型作为对象进行反序列化。
在处理自己的基类型和派生类型时,通常需要使用 xref:System.Runtime.Serialization.KnownTypeAttribute、xref:System.ServiceModel.ServiceKnownTypeAttribute 或与之等效的机制。 例如,如果某项操作具有Animal返回值和它返回实际的实例Cat(派生自Animal),您应将应用xref:System.Runtime.Serialization.KnownTypeAttribute到Animal类型或xref:System.ServiceModel.ServiceKnownTypeAttribute到该操作并指定Cat中这些属性的类型。 有关详细信息,请参阅Data Contract Known Types。
有关多态序列化工作方式的详细信息,以及使用多态序列化时必须遵从的部分限制的讨论,请参见本主题后面的“高级信息”一节。
版本管理
JSON 中完全支持数据协定版本管理功能,其中包括 xref:System.Runtime.Serialization.IExtensibleDataObject 接口。 不仅如此,在多数情况下还可以将一个类型反序列化为一种格式(例如 XML),然后再将其序列化为另一种格式(例如 JSON),同时仍然保留 xref:System.Runtime.Serialization.IExtensibleDataObject 中的数据。 有关详细信息,请参阅向前兼容的数据协定。 请记住,JSON 不进行排序,因此所有顺序信息都将丢失。 而且,JSON 不支持多个键/值对使用同一键名。 最后,对 xref:System.Runtime.Serialization.IExtensibleDataObject 执行的所有操作在本质上都是多态的,即它们的派生类型均被分配给所有类型的基类型 xref:System.Object。
URL 中的 JSON
在结合使用 ASP.NET AJAX 终结点与 HTTP GET 谓词(使用 xref:System.ServiceModel.Web.WebGetAttribute 属性)时,传入的参数将出现在请求 URL 而不是消息正文中。 JSON 支持甚至在请求 URL 中,因此,如果某项操作采用Int名为"number"和一个Person复杂类型名为"p",该 URL 可能类似于以下 URL。
http://example.com/myservice.svc/MyOperation?number=7&p={"name":"John","age":42}
如果使用 ASP.NET AJAX 脚本管理器控件和代理调用服务,则此 URL 将由代理自动生成,而不会显示出来。 JSON 不能用在非 ASP.NET AJAX 终结点上的 URL 中。
高级信息
ISerializable 支持
受支持和不受支持的 ISerializable 类型
通常情况下,序列化/反序列化 JSON 时完全支持实现 xref:System.Runtime.Serialization.ISerializable 接口的类型。 但是,其中有些类型(包括一些 .NET Framework 类型)采用特殊的实现方式,以致以下 JSON 特定的序列化方面会导致它们不能正确地反序列化:
-
使用 xref:System.Runtime.Serialization.ISerializable 时,各个数据成员的类型始终无法提前预知。 这将导致与将类型反序列化为对象时类似的多态情况。 正如前文所述,这在 JSON 中可能会导致类型信息丢失。 例如,如果某类型在其
enum实现中序列化一个 xref:System.Runtime.Serialization.ISerializable,则当其尝试直接反序列化回enum(未执行正确的强制转换)时将失败。这是因为,enum使用 JSON 中的数字进行序列化,而 JSON 数字却反序列化为内置的 .NET 数值类型(Int32、Decimal 或 Double)。 因此,数字用于enum值的事实将丢失。 -
在反序列化构造函数中依赖特定的反序列化顺序的 xref:System.Runtime.Serialization.ISerializable 类型可能也无法反序列化某些 JSON 数据,因为大多数 JSON 序列化程序并不能保证遵循任何特定的顺序。
工厂类型
虽然 JSON 中通常支持 xref:System.Runtime.Serialization.IObjectReference 接口,但它不支持需要“工厂类型”功能(从 xref:System.Runtime.Serialization.IObjectReference.GetRealObject(System.Runtime.Serialization.StreamingContext) 中返回与实现接口的类型不同的类型实例)的任何类型。
DateTime 连网格式
xref:System.DateTime 值显示为“/Date(700000+0500)/”形式的 JSON 字符串,其中第一个数字(在提供的示例中为 700000)是 GMT 时区中自 1970 年 1 月 1 日午夜以来按正常时间(非夏令时)经过的毫秒数。 该数字可以是负数,以表示之前的时间。 示例中包括“+0500”的部分可选,它指示该时间属于 xref:System.DateTimeKind.Local 类型,即它在反序列化时应转换为本地时区。 如果没有该部分,则会将时间反序列化为 xref:System.DateTimeKind.Utc。 实际数字(本示例中为“0500”)及其符号(+ 或 -)将被忽略。
序列化 xref:System.DateTime 时,写入的 xref:System.DateTimeKind.Local 和 xref:System.DateTimeKind.Unspecified 时间将带有偏移量,而写入的 xref:System.DateTimeKind.Utc 则不带偏移量。
ASP.NET AJAX 客户端 JavaScript 代码会自动将此类字符串转换为 JavaScript DateTime 实例。 如果有其他字符串采用了类似的形式,则即使它们不属于 .NET 中的 xref:System.DateTime 类型,也会对它们执行转换。
如果"/"字符进行转义,只需将放置的转换 (即,JSON 如下所示"\/Date(700000+0500)\/"),以及此原因 WCF 的 JSON 编码器 (情况下启用xref:System.ServiceModel.WebHttpBinding) 始终对"/"字符进行转义。
JSON 字符串中的 XML
XmlElement
xref:System.Xml.XmlElement 按原样执行序列化,而不进行包装。 例如,"x"类型的数据成员xref:System.Xml.XmlElement,其中包含<abc / > 是表示,如下所示的那样。
{"x":"<abc/>"}
XmlNode 数组
在 xref:System.Array 类型的标准数据协定命名空间内,该类型的 xref:System.Xml.XmlNode 对象被包装在一个称为 ArrayOfXmlNode 的元素中。 如果“x”是一个数组,并包含命名空间“ns”中的属性节点“N”,且该属性节点又包含“value”和一个空元素节点“M”,则可以按以下方式表示该数组。
{"x":"<ArrayOfXmlNode xmlns=\"http://schemas.datacontract.org/2004/07/System.Xml\" a:N=\"value\" xmlns:a=\"ns\"><M/></ArrayOfXmlNode>"}
XmlNode 数组的开头(在其他元素之前)不支持空命名空间中的属性。
包括 XElement 和 DataSet 的 IXmlSerializable 类型
xref:System.Runtime.Serialization.ISerializable 类型可分为“内容类型”、“数据集类型”和“元素类型”。 有关这些类型的定义,请参阅数据协定中的 XML 和 ADO.NET 类型。
“内容”和“数据集”类型类似,它们都会被序列化为上一节中所讨论的 xref:System.Array 的 xref:System.Xml.XmlNode 对象。 它们的包装元素的名称和命名空间与数据协定的名称和相应类型的命名空间相对应。
“元素”类型(例如 xref:System.Xml.Linq.XElement)按原样序列化,这与本主题前面讨论的 xref:System.Xml.XmlElement 类似。
多态性
保留类型信息
正如前文所述,JSON 中支持多态性,但有一些限制。 JavaScript 是一种弱类型语言,类型标识通常并不会产生问题。 但是,当使用 JSON 在强类型系统 (.NET) 与弱类型系统 (JavaScript) 之间进行通信时,保留类型标识将十分有用。 例如,数据协定名称为“Square”和“Circle”的类型派生自数据协定名称为“Shape”的类型。 如果将“Circle”从 .NET 发送至 JavaScript,随后又将其返回给某个需要“Shape”的 .NET 方法,则 .NET 端就需要它以知道该对象最初为“Circle”,否则任何特定于派生类型的信息(例如,“Circle”上的“radius”数据成员)都可能丢失。
若要保留类型标识,可以在将复杂类型序列化为 JSON 时添加“类型提示”。这样,反序列化程序在识别该提示后,便可以执行相应的操作。 "类型提示"是具有键名称的 JSON 键/值对"__类型"(两个下划线后跟单词"type")。 该值是一个 JSON 字符串,其形式为“数据协定名称:数据协定命名空间”(第一个冒号前的所有内容都是名称)。 在前面的示例中,“Circle”可以按以下方式进行序列化。
{"__type":"Circle:http://example.com/myNamespace","x":50,"y":70,"radius":10}
类型提示与 xsi:type 属性非常相似,此属性由 XML 架构实例标准定义,供序列化/反序列化 XML 时使用。
数据成员命名为"__类型"禁止由于与类型提示的潜在冲突。
减小类型提示的大小
若要缩小的 JSON 消息的默认数据协定命名空间前缀 (http://schemas.datacontract.org/2004/07/) 将被替换为"#"字符。 (若要进行此替换可逆,请使用一项转义规则: 如果在命名空间以"#"或"\"个字符,后面附加了一个额外"\"字符)。 因此,如果"Circle"是.NET 命名空间"MyApp.Shapes"中的类型,其默认数据协定命名空间是 http://schemas.datacontract.org/2004/07/MyApp 。 下面是 Shapes 及其 JSON 表示形式。
{"__type":"Circle:#MyApp.Shapes","x":50,"y":70,"radius":10}
截断 (#MyApp.Shapes) 和完整 (http://schemas.datacontract.org/2004/07/MyApp.Shapes) 名称理解在反序列化。
JSON 对象中的类型提示位置
请注意,类型提示必须出现在 JSON 表示形式的开头。 这是 JSON 处理中唯一一种重视键/值对顺序的情况。 例如,下面不是指定类型提示的有效方式。
{"x":50,"y":70,"radius":10,"__type":"Circle:#MyApp.Shapes"}
这两个xref:System.Runtime.Serialization.Json.DataContractJsonSerializerWCF 和 ASP.NET AJAX 使用的客户端页面始终发出类型提示第一次。
类型提示仅适用于复杂类型
对于非复杂类型,无法发出类型提示。 例如,如果操作的返回类型为 xref:System.Object,但却返回了 Circle,则 JSON 表示形式可能像前面显示的那样保留了类型信息。 但是,如果返回了 URI,则 JSON 表示形式将是一个字符串,而该字符串原来用于表示 URI 的事实将丢失。 这不仅适用于基元类型,也适用于集合和数组。
发出类型提示的时机
类型提示可能会显著增大消息的大小(缓解此问题的一种方式是尽量使用较短的数据协定命名空间)。 因此,在确定是否发出类型提示时,应循序下列规则:
-
使用 ASP.NET AJAX 时,始终都应尽可能多地发出类型提示,即使不存在基分配/派生分配(例如,将 Circle 分配给 Circle)也不例外。 (这是完全实现从弱类型的 JSON 环境调入强类型的 .NET 环境,又不造成大量信息丢失所必需的。)
-
如果在未与 ASP.NET 集成的情况下使用 AJAX 服务,则只有当存在基分配/派生分配时才应发出类型提示,即在将 Circle 分配给 Shape 或 xref:System.Object 而不是分配给 Circle 时发出。 这不仅满足了正确实现 JavaScript 客户端所需的信息,而且在最大程度上减少了这些信息,从而提高了性能。但是,如果客户端的设计有误,则无法防止类型信息丢失。 如果要避免处理此客户端问题,请同时避免服务器上的基分配/派生分配。
-
使用 xref:System.Runtime.Serialization.DataContractSerializer 类型时,
alwaysEmitTypeInformation构造函数参数允许您在前面两种模式之间进行选择,其默认值为“false”(仅在需要时才发出类型提示)。
重复的数据成员名称
派生类型信息和基类型信息共同存在于同一个 JSON 对象中,且可以按任意顺序出现。 例如,Shape可能出现,如下所示。
{"__type":"Shape:#MyApp.Shapes","x":50,"y":70}
而 Circle 则可以表示为以下形式。
{"__type":"Circle:#MyApp.Shapes","x":50, "radius":10,"y":70}
如果基Shape还包含一个名为的数据成员类型"radius",这会导致冲突发生在两个序列化 (因为 JSON 对象不能具有重复的键名称) 和反序列化 (因为它是不清楚是否"radius"指Shape.radius或Circle.radius)。 因此,虽然一般不建议在数据协定类中使用“属性隐藏”概念(基类和派生类中的数据成员同名),但 JSON 中实际上禁止这种情况。
多态性和 IXmlSerializable 类型
根据常规数据协定规则,只要满足已知类型需求,就可以用多态形式将 xref:System.Xml.Serialization.IXmlSerializable 类型正常分配给彼此。 但是,如果用序列化 xref:System.Xml.Serialization.IXmlSerializable 类型代替序列化 xref:System.Object,则会像 JSON 字符串那样导致类型信息丢失。
多态性和某些接口类型
在需要非 xref:System.Xml.Serialization.IXmlSerializable 的非集合类型(xref:System.Xml.Serialization.IXmlSerializable 除外)时,禁止序列化集合类型或实现 xref:System.Object 的类型。 例如,自定义接口称为IMyInterface并键入MyType这两者均实现xref:System.Collections.Generic.IEnumerable`1类型的int和IMyInterface。 禁止返回MyType从其返回类型是的操作IMyInterface。 这是因为MyType必须序列化为 JSON 数组和需要类型提示,并如之前所述,则不能包含类型提示仅具有复杂类型数组。
已知类型和配置
xref:System.Runtime.Serialization.DataContractSerializer 使用的所有已知类型机制同样受 xref:System.Runtime.Serialization.Json.DataContractJsonSerializer 支持。 这两个序列化程序读取同一配置元素 <dataContractSerializer >中 <system.runtime.serialization >,以发现添加的已知的类型通过配置文件。
分配给对象的集合
序列化分配给对象的集合时,会将它们视为实现 xref:System.Collections.Generic.IEnumerable`1 的集合:一个 JSON 数组,其中属于复杂类型的每一项都具有类型提示。 例如,xref:System.Collections.Generic.List`1类型的Shape分配给xref:System.Object如下所示。
[{"__type":"Shape:#MyApp.Shapes","x":50,"y":70},
{"__type":"Shape:#MyApp.Shapes","x":58,"y":73},
{"__type":"Shape:#MyApp.Shapes","x":41,"y":32}]
当反序列化回 xref:System.Object 时:
-
Shape必须是已知类型列表中。 无xref:System.Collections.Generic.List`1类型的Shape到已知类型中不起作用。 请注意,无需添加Shape到已知类型在序列化这种情况下-这自动完成。 -
集合反序列化为xref:System.Array类型的xref:System.Object,其中包含
Shape实例。
分配给基集合的派生集合
将派生集合分配给基集合时,通常会将该集合作为基类型的集合进行序列化。 但是,如果派生集合的项类型不能分配给基集合的项类型,则会引发异常。
类型提示和字典
将字典分配给 xref:System.Object 时,字典中的每个键和值项都将被视为已分配给 xref:System.Object 并会获得类型提示。
序列化字典类型时,包含“Key”和“Value”成员的 JSON 对象不会受 alwaysEmitTypeInformation 设置的影响,并只有在前面的集合规则需要时才会包含类型提示。
有效的 JSON 键名
序列化程序 XML 编码的键名不是有效的 XML 名称。 例如,名为"123"的数据成员必须的编码的名称,如"_x0031__x0032__x0033_"因为"123"是无效的 XML 元素名称 (开头数字)。 在 XML 名称中,如果某些国际字符集无效,也会出现类似的情况。 XML 对 JSON 处理这种效果的说明,请参阅Mapping Between JSON and XML。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
