DOCSP-49095: Retryable Reads and Writes

Author: mcmorisi

source/crud/configure.txt

@@ -191,6 +191,26 @@ The following example sets the read preference to ``ReadPreference.Secondary`` f
 For more information about read preference, see :manual:`Read Preference
 </core/read-preference/>` in the {+mdb-server+} manual.
 
+Retryable Reads and Writes
+--------------------------
+
+The {+driver-short+} automatically retries certain read and write operations a single time
+if they fail due to a network or server error.
+
+You can explicitly disable retryable reads or retryable writes by setting the ``RetryReads``
+or ``RetryWrites`` options on a ``MongoClientSettings`` object and passing this object to the
+``MongoClient`` constructor. The following example disables retryable reads and writes for
+a client:
+
+.. literalinclude:: /includes/fundamentals/code-examples/ReplicaSetConfigs.cs
+   :start-after: start-retry-reads-writes
+   :end-before: end-retry-reads-writes
+   :language: csharp
+   :dedent:
+
+To learn more about supported retryable reads and retryable writes, see :manual:`Retryable Reads </core/retryable-reads/>`
+and :manual:`Retryable Writes </core/retryable-writes/>` in the {+mdb-server+} manual.
+
 API Documentation
 -----------------
 

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

@@ -8,7 +8,7 @@ public static void Main(string[] args)
         var client = new MongoClient("mongodb://localhost:27017");
         {
             // start-write-concern-client
-            var mongoClientSettings = MongoClientSettings.FromConnectionString("<connection string URI>");
+            var mongoClientSettings = MongoClientSettings.FromConnectionString("<connection URI>");
             mongoClientSettings.WriteConcern = WriteConcern.WMajority;
             var mongoClient = new MongoClient(mongoClientSettings);
             // end-write-concern-client
@@ -24,7 +24,7 @@ public static void Main(string[] args)
 
         {
             // start-read-concern-client
-            var mongoClientSettings = MongoClientSettings.FromConnectionString("<connection string URI>");
+            var mongoClientSettings = MongoClientSettings.FromConnectionString("<connection URI>");
             mongoClientSettings.ReadConcern = ReadConcern.Majority;
             var mongoClient = new MongoClient(mongoClientSettings);
             // end-read-concern-client
@@ -40,7 +40,7 @@ public static void Main(string[] args)
 
         {
             // start-read-preference-client
-            var mongoClientSettings = MongoClientSettings.FromConnectionString("<connection string URI>");
+            var mongoClientSettings = MongoClientSettings.FromConnectionString("<connection URI>");
             mongoClientSettings.ReadPreference = ReadPreference.Secondary;
             var mongoClient = new MongoClient(mongoClientSettings);
             // end-read-preference-client
@@ -53,5 +53,14 @@ public static void Main(string[] args)
                                      .WithReadPreference(ReadPreference.Secondary);
             // end-read-preference-collection
         }
+
+        {
+            // start-retry-reads-writes
+            var mongoClientSettings = MongoClientSettings.FromConnectionString("<connection URI>");
+            mongoClientSettings.RetryReads = false;
+            mongoClientSettings.RetryWrites = false;
+            var mongoClient = new MongoClient(mongoClientSettings);
+            // end-retry-reads-writes
+        }
     }
 }