c#对象为null时,序列化输出的内容取决于使用的具体序列化库和配置。以最常见的system.text.json为例,默认情况下会输出json null;若开启了writenull选项(默认开启),则输出字符串"null";若关闭该选项,则直接跳过该属性不输出任何内容。对于newtonsoft.json,默认行为也是输出"null",但可通过nullvaluehandling设置为ignore来省略该字段。

System.Text.Json默认如何处理null值
在.NET 6及更高版本中,使用内置的System.Text.Json库时,当属性值为null且未进行特殊配置,序列化器会将该属性序列化为JSON中的null字面量。这意味着生成的JSON字符串中会包含键名后跟冒号和null,例如{"Name":null}。这种行为是默认的,旨在保持数据结构的完整性,明确指示该字段存在但无值。

using System;
using System.Text.Json;
public class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
class Program
{
static void Main()
{
var person = new Person { Name = null, Age = 30 };
var options = new JsonSerializerOptions(); // 默认配置
string json = JsonSerializer.Serialize(person, options);
Console.WriteLine(json); // 输出: {"Name":null,"Age":30}
}
}
上述代码展示了默认行为。运行结果中,Name属性因为值为null,被序列化为"null"。如果希望改变这一行为,可以修改JsonSerializerOptions。
如何忽略null值以避免输出
在许多API场景中,为了减小负载或避免歧义,开发者倾向于完全省略null值的字段。在System.Text.Json中,可以通过设置DefaultIgnoreCondition为WhenWritingNull来实现这一点。这样,当属性值为null时,序列化器将不会为该属性生成任何JSON片段,从而使得最终输出的JSON字符串中不包含该键。

using System;
using System.Text.Json;
public class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
class Program
{
static void Main()
{
var person = new Person { Name = null, Age = 30 };
var options = new JsonSerializerOptions
{
DefaultIgnoreCondition = System.Text.Json.Serialization.JsonIgnoreCondition.WhenWritingNull
};
string json = JsonSerializer.Serialize(person, options);
Console.WriteLine(json); // 输出: {"Age":30}
}
}
在此配置下,Name属性因值为null而被忽略,最终JSON仅包含Age。这种处理方式在构建RESTful API响应时非常常见,能有效减少不必要的网络传输数据。
Newtonsoft.Json中忽略null值的配置差异
如果使用第三方库Newtonsoft.Json(Json.NET),其处理null值的机制与内置库类似但配置项不同。通过设置NullValueHandling为NullValueHandling.Ignore,可以实现与System.Text.Json中DefaultIgnoreCondition相同的效果,即跳过null属性的序列化。这允许开发者根据项目依赖选择最合适的库并应用相应的最佳实践。











