C# Bson序列化特性 MongoDB.Bson.Serialization.Attributes

▲相关特性MongoDB.Bson.Serialization.Attributes

MongoDB序列化特性官方文档：

[BsonIgnore]

[BsonElement]

[BsonIgnoreExtraElements]

[BsonExtraElements]

[BsonRepresentation(BsonType.String)]

[BsonId]

2.可以忽略某些字段

[BsonIgnore]该标签用来禁止字段序列化，不保存数据库也不查询，即忽略。

3.支持默认值以及取别名

[BsonElement] 字段加上该标签，即使是private字段也会序列化(默认只序列化public字段)，该标签还可以带一个string参数，给字段序列化指定别名。

[BsonIgnore]//忽略保存进数据库，禁止字段序列化。
public Entity Entity
[BsonIgnore]//组件类中
public NavGraph[] graphs;

//默认private不会序列化，加上BsonElement就会序列化
[BsonElement("C")]
[BsonIgnoreIfNull]
private HashSet<Component> components = new HashSet<Component>();

元素顺序

如果要精确控制BSON文档中元素的顺序，可以对BsonElement属性使用Order named参数：

public class MyClass 
{
    [BsonElement("sp", Order = 1)]
    public string SomeProperty { get; set; }
}

4.升级版本支持

[BsonIgnoreExtraElements] 该标签用在class上面，反序列化时用来忽略多余的字段，一般版本兼容需要考虑，低版本的协议需要能够反 序列化高版本的内容,否则新版本删除字段，旧版本结构反序列化会出错

5.支持额外的元素

[BsonExtraElements]

您可以将您的类设计为能够处理反序列化期间在BSON文档中可能发现的任何其他元素。为此，您必须具有BsonDocument（或IDictionary<string, object>）类型的属性，并且必须将该属性标识为应该包含找到的任何其他元素的属性。按照惯例，可以命名该成员ExtraElements。例如：

public MyClass 
{
// fields and properties
[BsonExtraElements]
public BsonDocument CatchAll { get; set; }
}

6.表示，枚举：

[BsonRepresentation(BsonType.String)]

对于某些.NET基本类型，您可以控制要用来表示值的BSON类型。例如，您可以指定将char值表示为BSON Int32还是一字符BSON字符串：

默认情况下，枚举表示为其基础值。换句话说，纯枚举将表示为整数值。但是，可以指示驱动程序将枚举表示为字符串。

//告诉mongodb这个字段在数据库中的类型是String
[BsonRepresentation(BsonType.String)]
public AppType AppType { get; set; }
//告诉mongodb这个字段在数据库中的类型是ObjectId
[BsonRepresentation(BsonType.ObjectId)]
public class MyClass 
{
    [BsonRepresentation(BsonType.Int32)]
public char RepresentAsInt32 { get; set; }
}

//默认是国际时间

[BsonDateTimeOptions(Kind = DateTimeKind.Local)]//单独指定时区

[BsonDictionaryOptions(DictionaryRepresentation.ArrayOfArrays)]

DictionaryRepresentation有三个值可选：

[BsonRepresentation(BsonType.String)]

ET框架中，保存数据库组件需要继承 ISerializeToEntity接口。

[BsonDictionaryOptions(DictionaryRepresentation.ArrayOfArrays)]
public Dictionary<int, int> MyAreaDict = new Dictionary<int, int>();

//class上面，反序列化时用来忽略多余的字段，否则新版本加了字段，旧版本结构反序列化会出错
[BsonIgnoreExtraElements]
public class CheckPointConfig : IConfig

7.指定默认值：[BsonDefaultValue(0L)]

您可以使用来为成员指定默认值BsonDefaultValueAttribute：

8.忽略默认值：

[BsonIgnoreIfDefault]

[BsonId]

id编号产生器：[BsonId(IdGenerator = typeof(CombGuidGenerator))]

当您插入文档时，驱动程序将检查是否已为该Id成员分配了值，如果没有，则为该成员生成一个新的唯一值。由于Id成员可以是任何类型，因此驱动程序需要借助IIdGenerator来检查成员是否Id具有为其分配的值，并在必要时生成新值。该驱动程序具有以下内置的ID生成器：

• ObjectIdGenerator
• StringObjectIdGenerator
• GuidGenerator
• CombGuidGenerator
• NullIdChecker
• ZeroIdChecker<T>
• BsonObjectIdGenerator

其中一些ID生成器会自动用于常用Id类型：

• GuidGenerator 用于 Guid
• ObjectIdGenerator 用于 ObjectId
• StringObjectIdGenerator用于string外部表示ObjectId

要通过属性指定ID生成器，请执行以下操作：

public class MyClass 
{
    [BsonId(IdGenerator = typeof(CombGuidGenerator))]
    public Guid Id { get; set; }
}

或通过代码：

BsonClassMap.RegisterClassMap<MyClass>(cm => 
{
    cm.AutoMap();
    cm.MapIdMember(c => c.Id).SetIdGenerator(CombGuidGenerator.Instance);
});

[BsonElement] 字段加上该标签，即使是private字段也会序列化(默认只序列化public字段，readonly)，该标签还可以带一个string参数，给字段序列化指定别名。

[BsonIgnoreExtraElements]
public abstract class ComponentWithId : Component
{
[BsonIgnoreIfDefault]
[BsonDefaultValue(0L)]//指定默认值
[BsonElement]
[BsonId]//定义为主键，字段映射，告诉mongodb这个字段在数据库中对应_id，这个字段一般不需要在Json中体现出来，在序列化时被忽略
public long Id { get; set; }

//默认是国际时间
[BsonDateTimeOptions(Kind = DateTimeKind.Local)]//单独指定时区

MongoDB.Driver中的Bson特性

namespace MongoDB.Driver
{
[BsonElement("max")]
public TValue Max => _max;

[BsonElement("count")]
public long Count { get; private set; }

BsonSerializerAttribute：


//这里是Bson库的序列化器

namespace MongoDB.Driver.GeoJsonObjectModel
{
[BsonSerializer(typeof(GeoJson2DGeographicCoordinatesSerializer))]

public class GeoJson2DGeographicCoordinates : GeoJsonCoordinates