DOCSP-47510 Add new aggregation operation examples (#55)

Author: jordan-smith721

source/fundamentals/query-data.txt

@@ -169,9 +169,124 @@ on the ``name`` field.
    When sorting on fields with a boolean value, entities with a field value of
    ``false`` show before those with a value of ``true``.
 
+Scalar Aggregations
+-------------------
+
+The {+provider-short+} supports the following scalar aggregation methods:
+
+- ``Count()``: Returns the number of elements in a collection or the number of
+  documents that match a predicate
+- ``LongCount()``: Returns the number of elements in a collection as a ``long``
+  or the number of documents that match a predicate
+- ``Any()``: Returns ``true`` if any elements in a collection match the predicate
+- ``Max()``: Returns the maximum value of a specified field in a collection
+- ``Min()``: Returns the minimum value of a specified field in a collection
+- ``Sum()``: Returns the sum of values of a specified field in a collection
+- ``Average()``: Returns the average of values of a specified field in a collection
+
+The following sections show examples of each of the preceding methods.
+
+Count
+~~~~~
+
+The following example uses the ``Count()`` method to count the number of elements in the
+``Planets`` collection:
+
+.. literalinclude:: /includes/fundamentals/code-examples/aggregation.cs
+   :language: csharp
+   :start-after: // start-count
+   :end-before: // end-count
+
+The following example uses the ``Count()`` method to count the number of elements in the
+``Planets`` collection that have a ``hasRings`` field set to ``true``:
+
+.. literalinclude:: /includes/fundamentals/code-examples/aggregation.cs
+   :language: csharp
+   :start-after: // start-count-predicate
+   :end-before: // end-count-predicate
+
+LongCount
+~~~~~~~~~
+
+The following example uses the ``LongCount()`` method to count the number of
+elements in the ``Planets`` collection and returns the result as a ``long``:
+
+.. literalinclude:: /includes/fundamentals/code-examples/aggregation.cs
+   :language: csharp
+   :start-after: // start-long-count
+   :end-before: // end-long-count
+
+The following example uses the ``LongCount()`` method to count the number of
+elements in the ``Planets`` collection that have a ``hasRings`` field set to
+``true`` and returns the result as a ``long``:
+
+.. literalinclude:: /includes/fundamentals/code-examples/aggregation.cs
+   :language: csharp
+   :start-after: // start-long-count-predicate
+   :end-before: // end-long-count-predicate
+
+Any
+~~~
+
+The following example uses the ``Any()`` method to check if any elements in the
+``Planets`` collection have a ``hasRings`` field set to ``true``:
+
+.. literalinclude:: /includes/fundamentals/code-examples/aggregation.cs
+   :language: csharp
+   :start-after: // start-any
+   :end-before: // end-any
+
+Max
+~~~
+
+The following example uses the ``Max()`` method to find the maximum value of the
+``orderFromSun`` field in the ``Planets`` collection:
+
+.. literalinclude:: /includes/fundamentals/code-examples/aggregation.cs
+   :language: csharp
+   :start-after: // start-max
+   :end-before: // end-max
+
+Min
+~~~
+
+The following example uses the ``Min()`` method to find the minimum value of the
+``orderFromSun`` field in the ``Planets`` collection:
+
+.. literalinclude:: /includes/fundamentals/code-examples/aggregation.cs
+   :language: csharp
+   :start-after: // start-min
+   :end-before: // end-min
+
+Sum
+~~~
+
+The following example uses the ``Sum()`` method to find the sum of the
+``mass`` field in the ``Planets`` collection:
+
+.. literalinclude:: /includes/fundamentals/code-examples/aggregation.cs
+   :language: csharp
+   :start-after: // start-sum
+   :end-before: // end-sum
+
+Average
+~~~~~~~
+
+The following example uses the ``Average()`` method to find the average value of
+the ``mass`` field in the ``Planets`` collection:
+
+.. literalinclude:: /includes/fundamentals/code-examples/aggregation.cs
+   :language: csharp
+   :start-after: // start-average
+   :end-before: // end-average
+
+
 Additional Information
 ----------------------
 
+To learn more about aggregations in MongoDB, see the :manual:`Aggregation
+Operations </aggregation>` guide in the {+mdb-server+} manual.
+
 To learn more about the methods discussed in this guide, see the following .NET API
 documentation links:
 

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

@@ -0,0 +1,55 @@
+// start-count
+var planetCount = db.Planets.Count();
+
+Console.WriteLine("Planet Count: " + planetCount);
+// end-count
+
+// start-count-predicate
+var planetCountWithRings = db.Planets.Count(p => p.hasRings);
+
+Console.WriteLine("Planet Count with Rings: " + planetCountWithRings);
+// end-count-predicate
+
+// start-long-count
+var planetCountLong = db.Planets.LongCount();
+
+Console.WriteLine("Long Planet Count: " + longCount);
+// end-long-count
+
+// start-long-count-predicate
+var planetCountLongWithRings = db.Planets.LongCount(p => p.hasRings);
+
+Console.WriteLine("Long Planet Count with Rings: " + planetCountLongWithRings);
+// end-long-count-predicate
+
+// start-any
+var results = db.Planets.Any(p => p.hasRings);
+
+foreach (var p in results)
+{
+    Console.WriteLine("Planet with Rings: " + p.name);
+}
+// end-any
+
+// start-max
+var furthestPlanet = db.Planets.Max(p => p.orderFromSun);
+
+Console.WriteLine("Furthest Planet: " + furthestPlanet.name);
+// end-max
+
+// start-min
+var closestPlanet = db.Planets.Min(p => p.OrderFromSun);
+
+Console.WriteLine("Closest Planet: " + closestPlanet.Name);
+// end-min
+
+// start-sum
+var totalMass = db.Planets.Sum(p => p.mass);
+Console.WriteLine("Total Mass of Planets: " + totalMass);
+// end-sum
+
+// start-average
+var averageMass = db.Planets.Average(p => p.mass);
+
+Console.WriteLine("Average Mass of Planets: " + averageMass);
+// end-average

source/limitations.txt

@@ -43,20 +43,6 @@ types not recognized by {+framework+}.
 This version of the {+provider-short+} does not support
 Select Projections.
 
-Scalar Aggregations
-~~~~~~~~~~~~~~~~~~~
-
-Top-level scalar aggregations are operations you can perform on a query, such as
-``Count()``, ``Min()``, and ``Max()``. This version of the {+provider-short+}
-supports only the following scalar aggregation operations:
-
-- ``Count()``
-- ``LongCount()``
-- ``Any()``, with or without predicates
-
-This version of the {+provider-short+} does not support other scalar aggregation
-operations.
-
 Migrations
 ~~~~~~~~~~