Connecting to Redis on StackExchange.Redis (C#)

Prerequisites

• A Redis instance is created, and is in the Running state.
• An ECS has been created. For details about how to create an ECS, see Elastic Cloud Server User Guide
• If the ECS runs the Linux OS, ensure that the GCC compilation environment has been installed on the ECS.

Connecting to Redis on StackExchange.Redis

1. View the IP address/domain name and port number of the DCS Redis instance to be accessed.

   For details, see Distributed Cache Service User Guide > "Getting Started" > "Viewing Details of a DCS Instance".

2. Log in to the ECS.

   A Windows ECS is used as an example.

3. Install Visual Studio Community 2017 on the ECS.
4. Start Visual Studio 2017 and create a project.

   Set the project name to redisdemo.

5. Install StackExchange.Redis by using the NuGet package manager of Visual Studio.

   Access the NuGet package manager console according to Figure 1, and enter Install-Package StackExchange.Redis -Version 2.2.79. (The version number is optional).

   Figure 1 Accessing the NuGet package manager console
   

6. Write the following code, and use the String Set and Get methods to test the connection.

   using System;
   using StackExchange.Redis;
   
   namespace redisdemo
   {
       class Program
       {
           // redis config
           private static ConfigurationOptions connDCS = ConfigurationOptions.Parse("{instance_ip_address}:{port},password=********,connectTimeout=2000");
           //the lock for singleton
           private static readonly object Locker = new object();
           //singleton
           private static ConnectionMultiplexer redisConn;
           //singleton
           public static ConnectionMultiplexer getRedisConn()
           {
               if (redisConn == null)
               {
                   lock (Locker)
                   {
                       if (redisConn == null || !redisConn.IsConnected)
                       {
                           redisConn = ConnectionMultiplexer.Connect(connDCS);
                       }
                   }
               }
               return redisConn;
           }
           static void Main(string[] args)
           {
               redisConn = getRedisConn();
               var db = redisConn.GetDatabase();
               //set get
               string strKey = "Hello";
               string strValue = "DCS for Redis!";
               Console.WriteLine( strKey + ", " + db.StringGet(strKey));
   
               Console.ReadLine();
           }
       }
   }

   {instance_ip_address} and {port} are the IP address/domain name and port number of the DCS Redis instance. For details about how to obtain the IP address/domain name and port, see 1. Change them as required. ******** indicates the password used for logging in to the chosen DCS Redis instance. This password is defined during DCS Redis instance creation.

7. Run the code. You have successfully accessed the instance if the following command output is displayed:

   Hello, DCS for Redis!

   For more information about other commands of StackExchange.Redis, visit StackExchange.Redis.