DOC-5769 fixed content to add basic async examples and fix client name

Author: andy-stark-redis

content/develop/clients/dotnet/_index.md

@@ -36,45 +36,31 @@ dotnet add package NRedisStack
 
 ## Connect and test
 
-Connect to localhost on port 6379.
-
-```csharp
-using NRedisStack;
-using NRedisStack.RedisStackCommands;
-using StackExchange.Redis;
-//...
-ConnectionMultiplexer redis = ConnectionMultiplexer.Connect("localhost");
-IDatabase db = redis.GetDatabase();
-```
+Add the following imports to your source file:
+
+{{< clients-example set="landing" step="import" lang_filter="C#-Sync,C#-Async" >}}
+{{< /clients-example >}}
+
+Connect to localhost on port 6379. The client supports both synchronous and asynchronous commands.
+
+{{< clients-example set="landing" step="connect" lang_filter="C#-Sync,C#-Async" >}}
+{{< /clients-example >}}
 
 You can test the connection by storing and retrieving a simple string.
 
-```csharp
-db.StringSet("foo", "bar");
-Console.WriteLine(db.StringGet("foo")); // prints bar
-```
+{{< clients-example set="landing" step="set_get_string" lang_filter="C#-Sync,C#-Async" >}}
+{{< /clients-example >}}
 
 Store and retrieve a HashMap.
 
-```csharp
-var hash = new HashEntry[] { 
-    new HashEntry("name", "John"), 
-    new HashEntry("surname", "Smith"),
-    new HashEntry("company", "Redis"),
-    new HashEntry("age", "29"),
-    };
-db.HashSet("user-session:123", hash);
-
-var hashFields = db.HashGetAll("user-session:123");
-Console.WriteLine(String.Join("; ", hashFields));
-// Prints: 
-// name: John; surname: Smith; company: Redis; age: 29
-```
+{{< clients-example set="landing" step="set_get_hash" lang_filter="C#-Sync,C#-Async" >}}
+{{< /clients-example >}}
+
 ## Redis Open Source modules
 
 To access Redis Open Source capabilities, use the appropriate interface like this:
 
-```
+```cs
 IBloomCommands bf = db.BF();
 ICuckooCommands cf = db.CF();
 ICmsCommands cms = db.CMS();

content/develop/clients/dotnet/prob.md

@@ -99,15 +99,15 @@ add. The following example adds some names to a Bloom filter representing
 a list of users and checks for the presence or absence of users in the list.
 Note that you must use the `BF()` method to access the Bloom filter commands.
 
-{{< clients-example home_prob_dts bloom "C#" >}}
+{{< clients-example home_prob_dts bloom "C#-Sync" >}}
 {{< /clients-example >}}
 
 A Cuckoo filter has similar features to a Bloom filter, but also supports
 a deletion operation to remove hashes from a set, as shown in the example
 below. Note that you must use the `CF()` method to access the Cuckoo filter
 commands.
 
-{{< clients-example home_prob_dts cuckoo "C#" >}}
+{{< clients-example home_prob_dts cuckoo "C#-Sync" >}}
 {{< /clients-example >}}
 
 Which of these two data types you choose depends on your use case.
@@ -128,7 +128,7 @@ You can also merge two or more HyperLogLogs to find the cardinality of the
 [union](https://en.wikipedia.org/wiki/Union_(set_theory)) of the sets they
 represent.
 
-{{< clients-example home_prob_dts hyperloglog "C#" >}}
+{{< clients-example home_prob_dts hyperloglog "C#-Sync" >}}
 {{< /clients-example >}}
 
 The main benefit that HyperLogLogs offer is their very low
@@ -169,7 +169,7 @@ a Count-min sketch object, add data to it, and then query it.
 Note that you must use the `CMS()` method to access the Count-min
 sketch commands.
 
-{{< clients-example home_prob_dts cms "C#" >}}
+{{< clients-example home_prob_dts cms "C#-Sync" >}}
 {{< /clients-example >}}
 
 The advantage of using a CMS over keeping an exact count with a
@@ -202,7 +202,7 @@ shows how to merge two or more t-digest objects to query the combined
 data set. Note that you must use the `TDIGEST()` method to access the
 t-digest commands.
 
-{{< clients-example home_prob_dts tdigest "C#" >}}
+{{< clients-example home_prob_dts tdigest "C#-Sync" >}}
 {{< /clients-example >}}
 
 A t-digest object also supports several other related commands, such
@@ -225,5 +225,5 @@ top *k* items and query whether or not a given item is in the
 list. Note that you must use the `TOPK()` method to access the
 Top-K commands.
 
-{{< clients-example home_prob_dts topk "C#" >}}
+{{< clients-example home_prob_dts topk "C#-Sync" >}}
 {{< /clients-example >}}

content/develop/clients/dotnet/transpipe.md

@@ -37,7 +37,7 @@ versions of the standard command methods
 buffered in the pipeline and only execute when you call the `Execute()`
 method on the pipeline object.
 
-{{< clients-example pipe_trans_tutorial basic_pipe "C#" >}}
+{{< clients-example pipe_trans_tutorial basic_pipe "C#-Sync" >}}
 {{< /clients-example >}}
 
 ## Execute a transaction
@@ -47,7 +47,7 @@ instance of the `Transaction` class, call async command methods
 on that object, and then call the transaction object's 
 `Execute()` method to execute it.
 
-{{< clients-example pipe_trans_tutorial basic_trans "C#" >}}
+{{< clients-example pipe_trans_tutorial basic_trans "C#-Sync" >}}
 {{< /clients-example >}}
 
 ## Watch keys for changes
@@ -77,7 +77,7 @@ For example, the `KeyNotExists` condition aborts the transaction
 if a specified key exists or is added by another client while the
 transaction executes:
 
-{{< clients-example pipe_trans_tutorial trans_watch "C#" >}}
+{{< clients-example pipe_trans_tutorial trans_watch "C#-Sync" >}}
 {{< /clients-example >}}
 
 You can also use a `When` condition on certain individual commands to

local_examples/client-specific/dotnet-async/AsyncLandingExample.cs

@@ -0,0 +1,63 @@
+// EXAMPLE: landing
+// STEP_START import
+using NRedisStack;
+using NRedisStack.RedisStackCommands;
+using StackExchange.Redis;
+// STEP_END
+// REMOVE_START
+using NRedisStack.Tests;
+using System.Threading.Tasks;
+
+namespace Doc;
+
+[Collection("DocsTests")]
+// REMOVE_END
+
+public class AsyncLandingExample
+// REMOVE_START
+: AbstractNRedisStackTest, IDisposable
+// REMOVE_END
+{
+    // REMOVE_START
+    public AsyncLandingExample(EndpointsFixture fixture) : base(fixture) { }
+
+    [SkippableFact]
+    // REMOVE_END
+    public async Task Run()
+    {
+        //REMOVE_START
+        // This is needed because we're constructing ConfigurationOptions in the test before calling GetConnection
+        SkipIfTargetConnectionDoesNotExist(EndpointsFixture.Env.Standalone);
+        var _ = GetCleanDatabase(EndpointsFixture.Env.Standalone);
+        //REMOVE_END
+        // STEP_START connect
+        var muxer = await ConnectionMultiplexer.ConnectAsync("localhost:6379");
+        var db = muxer.GetDatabase();
+        // STEP_END
+        //REMOVE_START
+        // Clear any keys here before using them in tests.
+        await db.KeyDeleteAsync(new RedisKey[] { "bike:1", "foo", "user-session:123" });
+        //REMOVE_END
+
+        // STEP_START set_get_string
+        await db.StringSetAsync("foo", "bar");
+        string? fooResult = await db.StringGetAsync("foo");
+        Console.WriteLine(fooResult); // >>> bar
+        // STEP_END
+
+        // STEP_START set_get_hash
+        var hash = new HashEntry[] { 
+            new HashEntry("name", "John"), 
+            new HashEntry("surname", "Smith"),
+            new HashEntry("company", "Redis"),
+            new HashEntry("age", "29"),
+            };
+        await db.HashSetAsync("user-session:123", hash);
+
+        var hashFields = await db.HashGetAllAsync("user-session:123");
+        Console.WriteLine(String.Join("; ", hashFields));
+        // >>> name: John; surname: Smith; company: Redis; age: 29
+        // STEP_END
+    }
+}
+

local_examples/client-specific/dotnet-sync/SyncLandingExample.cs

@@ -0,0 +1,61 @@
+// EXAMPLE: landing
+// STEP_START import
+using NRedisStack;
+using NRedisStack.RedisStackCommands;
+using StackExchange.Redis;
+// STEP_END
+// REMOVE_START
+using NRedisStack.Tests;
+
+namespace Doc;
+
+[Collection("DocsTests")]
+// REMOVE_END
+
+public class SyncLandingExample
+// REMOVE_START
+: AbstractNRedisStackTest, IDisposable
+// REMOVE_END
+{
+    // REMOVE_START
+    public SyncLandingExample(EndpointsFixture fixture) : base(fixture) { }
+
+    [SkippableFact]
+    // REMOVE_END
+    public void Run()
+    {
+        //REMOVE_START
+        // This is needed because we're constructing ConfigurationOptions in the test before calling GetConnection
+        SkipIfTargetConnectionDoesNotExist(EndpointsFixture.Env.Standalone);
+        var _ = GetCleanDatabase(EndpointsFixture.Env.Standalone);
+        //REMOVE_END
+        // STEP_START connect
+        var muxer = ConnectionMultiplexer.Connect("localhost:6379");
+        var db = muxer.GetDatabase();
+        // STEP_END
+        //REMOVE_START
+        // Clear any keys here before using them in tests.
+        db.KeyDelete(new RedisKey[] { "bike:1", "foo", "user-session:123" });
+        //REMOVE_END
+
+        // STEP_START set_get_string
+        db.StringSet("foo", "bar");
+        Console.WriteLine(db.StringGet("foo")); // >>> bar
+        // STEP_END
+
+        // STEP_START set_get_hash
+        var hash = new HashEntry[] {
+            new HashEntry("name", "John"),
+            new HashEntry("surname", "Smith"),
+            new HashEntry("company", "Redis"),
+            new HashEntry("age", "29"),
+        };
+        db.HashSet("user-session:123", hash);
+
+        var hashFields = db.HashGetAll("user-session:123");
+        Console.WriteLine(String.Join("; ", hashFields));
+        // >>> name: John; surname: Smith; company: Redis; age: 29
+        // STEP_END
+    }
+}
+