接上篇
忽略某字段或属性
手动构造类映射时您可以简单地通过不将字段或属性添加到类映射。当使用自动映射你需要指定应忽略该字段或属性的方法。可以使用属性编写如下编写:
public class MyClass { [BsonIgnore] public string SomeProperty { get; set; } }
或使用初始化代码而不属性:
BsonClassMap.RegisterClassMap<MyClass>(cm => { cm.AutoMap(); cm.UnmapProperty(c => c.SomeProperty); });
在这种情况下的自动映射将有最初属性自动添加到类映射但UnmapProperty会将其删除。
忽略空值
默认为空的值序列化到 BSON 文档时对应的 BSON字段为 Null。替代方法是序列化时忽略掉具有null值的字段或属性。要指定此使用如下属性编写:
public class MyClass { [BsonIgnoreIfNull] public string SomeProperty { get; set; } }
或使用初始化代码而不是属性:
BsonClassMap.RegisterClassMap<MyClass>(cm => { cm.AutoMap(); cm.GetMemberMap(c => c.SomeProperty).SetIgnoreIfNull(true); });
设置默认值
您可以指定一个字段或属性的默认值,如下所示:
public class MyClass { [BsonDefaultValue("abc")] public string SomeProperty { get; set; } }
或使用初始化代码而不使用属性:
BsonClassMap.RegisterClassMap<MyClass>(cm => { cm.AutoMap(); cm.GetMemberMap(c => c.SomeProperty).SetDefaultValue("abc"); });
您还可以控制是否将默认值序列化(默认值为是)。不序列化属性默认值做法:
public class MyClass { [BsonDefaultValue("abc")] [BsonIgnoreIfDefault] public string SomeProperty { get; set; } }
或使用初始化代码而不使用属性:
BsonClassMap.RegisterClassMap<MyClass>(cm => { cm.AutoMap(); cm.GetMemberMap(c => c.SomeProperty) .SetDefaultValue("abc") .SetIgnoreIfDefault(true); });
忽略基于ShouldSerializeXyz方法的成员
有时决定是否序列化一个成员比仅仅决定控制或者默认值是否序列化要复杂的多。您可以编写用于确定是否应序列化的方法。通常的方法成员Xyz被命名为ShouldSerializeXyz。如果您按照此命名约定然后自动映射将自动检测到方法和使用它。例如:
public class Employee { public ObjectId Id { get; set; } [BsonDateTimeOptions(DateOnly = true)] public DateTime DateOfBirth { get; set; } public bool ShouldSerializeDateOfBirth() { return DateOfBirth > new DateTime(1900, 1, 1); } }
或使用初始化代码而不是命名约定:
BsonClassMap.RegisterClassMap<Employee>(cm => { cm.AutoMap(); cm.GetMemberMap(c => c.DateOfBirth).SetShouldSerializeMethod( obj => ((Employee) obj).DateOfBirth > new DateTime(1900, 1, 1) ); });
确定必须字段
通常情况下,反序列化程序不关心将要被反序列化的文档是否不包含匹配的元素。不具有匹配元素的成员只是简单的获得分配给它们的默认值。
如果你想要使文档中的元素必须需要,您可以像这样标记单个字段或属性:
public class MyClass { public ObjectId Id { get; set; } [BsonRequired] public string X { get; set; } }
改为使用初始化代码的方法:
BsonClassMap.RegisterClassMap<MyClass>(cm => { cm.AutoMap(); cm.GetMemberMap(c => c.X).SetIsRequired(true); });
警告:
在反序列化时将会抛出一个异常,这种状态并不适用于序列化.
指定序列化程序
有时需要的序列化程序,而不是使用Bson库。可以通过下面几种方法来达到此目的:
public class MyClass { public ObjectId Id { get; set; } [BsonSerializer(typeof(MyCustomStringSerializer))] public string X { get; set; } }
改为使用初始化代码的方式:
BsonClassMap.RegisterClassMap<MyClass>(cm => { cm.AutoMap(); cm.GetMemberMap(c => c.X).SetSerializer(new MyCustomStringSerializer()); });
待续。。。。。