DOCSP-37272: Update and correct serialization-related code examples (#190)

DOCSP-37272: Update and correct serialization-related code examples

Author: mcmorisi

source/fundamentals/serialization.txt

@@ -84,9 +84,9 @@ The following code example shows a custom ``BsonRegularExpression`` serializer:
 
 .. code-block:: csharp
 
-   class CustomRegularExpressionSerializer : SerializerBase<RegularExpression>
+   class CustomRegularExpressionSerializer : SerializerBase<Regex>
    {
-       public override RegularExpression Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
+       public override Regex Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
      {
          var type = context.Reader.GetCurrentBsonType();
          switch (type)
@@ -101,7 +101,7 @@ The following code example shows a custom ``BsonRegularExpression`` serializer:
          }
      }
 
-     public override void Serialize(BsonSerializationContext context, BsonSerializationArgs args, RegularExpression value)
+     public override void Serialize(BsonSerializationContext context, BsonSerializationArgs args, Regex value)
      {
          context.Writer.WriteRegularExpression(value);
      }

source/fundamentals/serialization/poco.txt

@@ -599,6 +599,8 @@ serialization-related attributes:
 - ``[BsonRepresentation()]``, which specifies serialization of the ``Price`` field as a BSON ``Double`` type
 - ``[BsonDefaultValue()]``, which sets the ``Name`` property to
   ``"Generic item"`` if no value has been assigned to it
+- ``[BsonDateTimeOptions(DateOnly = true)]``, which specifies that the ``DateTime`` property
+  represents only a date value, with no associated time
 
 .. literalinclude:: ../../includes/fundamentals/code-examples/Clothing.cs
    :start-after: start-model
@@ -616,7 +618,14 @@ The following code instantiates a ``Clothing`` object and inserts the document i
        Name = "Denim Jacket",
        InStock = false,
        Price = 32.99m,
-       ColorSelection = new List<string> { "dark wash", "light wash" }
+       ColorSelection = new List<string> { "dark wash", "light wash" },
+       ListedDate = DateTime.Parse("Jan 1, 2007"),
+       SizeGuide = new Dictionary<string, string>()
+       {
+           {"Small", "Chest: 38\", Waist: 38\", Shoulders: 15\""},
+           {"Medium", "Chest: 40\", Waist: 40\", Shoulders: 15.5\""},
+           {"Large", "Chest: 42\", Waist: 40\", Shoulders: 16\""}
+       }
    };
 
    _myColl.InsertOne(doc);
@@ -631,7 +640,13 @@ The BSON representation of the inserted document looks like this:
      "name": "Denim Jacket",
      "inStock": false,
      "price": 32.99,
-     "colorSelection": [ "dark wash", "light wash" ]
+     "colorSelection": [ "dark wash", "light wash" ],
+     "listedDate" : ISODate("2007-01-01T00:00:00Z"),
+     "sizeGuide" : { 
+       "Small" : "Chest: 38\", Waist: 38\", Shoulders: 15\"", 
+       "Medium" : "Chest: 40\", Waist: 40\", Shoulders: 15.5\"", 
+       "Large" : "Chest: 42\", Waist: 40\", Shoulders: 16\"" 
+     }
    }
 
 Additional Information

source/includes/fundamentals/code-examples/Clothing.cs

@@ -21,5 +21,12 @@ public class Clothing
 
     [BsonElement("colorSelection")]
     public List<string> ColorSelection { get; set; }
+
+    [BsonElement("listedDate")]
+    [BsonDateTimeOptions(DateOnly = true)]
+    public DateTime ListedDate { get; set; }
+
+    [BsonElement("sizeGuide")]
+    public Dictionary<string, string> SizeGuide { get; set; }
 }
 // end-model