C#怎么连接Redis数据库 C# StackExchange.Redis客户端的使用方法

在C#项目中使用Redis数据库，StackExchange.Redis是最主流的客户端选择，它支持同步异步操作、集群、哨兵等多种Redis部署模式，适配绝大多数业务场景。下面将从安装到实战操作逐步介绍其使用方法。

StackExchange.Redis安装

首先需要在项目中引入StackExchange.Redis包，有两种常用安装方式：

NuGet包管理器安装

在Visual Studio中右键点击项目，选择管理NuGet程序包，搜索StackExchange.Redis，选择最新稳定版本点击安装即可。

命令行安装

如果使用.NET CLI，可以在项目目录下执行以下命令：

dotnet add package StackExchange.Redis

建立Redis连接

连接Redis需要先配置连接信息，StackExchange.Redis通过ConnectionMultiplexer类管理连接，它是线程安全的，整个应用建议只创建一个实例。

基础连接示例

以下是连接本地默认端口Redis的代码示例：

using StackExchange.Redis;
using System;

class RedisHelper
{
    // 单例连接对象，避免重复创建连接消耗资源
    private static ConnectionMultiplexer _redisConnection;
    private static readonly object _lockObj = new object();

    // 获取连接实例的方法
    public static ConnectionMultiplexer GetConnection()
    {
        if (_redisConnection == null || !_redisConnection.IsConnected)
        {
            lock (_lockObj)
            {
                if (_redisConnection == null || !_redisConnection.IsConnected)
                {
                    // 连接字符串，默认连接本地6379端口，无密码
                    string connectionString = "localhost:6379";
                    _redisConnection = ConnectionMultiplexer.Connect(connectionString);
                }
            }
        }
        return _redisConnection;
    }
}

带密码和自定义配置的连接

如果Redis设置了密码，或者需要自定义连接超时等参数，可以修改连接字符串：

// 带密码的连接字符串，设置连接超时5秒，同步超时3秒
string connectionString = "127.0.0.1:6379,password=your_redis_password,connectTimeout=5000,syncTimeout=3000";

常见数据类型操作

连接建立后，通过GetDatabase方法获取数据库实例，就可以进行各类数据操作。

字符串类型操作

字符串是Redis最基础的数据类型，支持设置、获取、过期时间设置等操作：

class RedisStringDemo
{
    public static void OperateString()
    {
        var db = RedisHelper.GetConnection().GetDatabase();
        // 设置键值对，过期时间30秒
        db.StringSet("user:name", "张三", TimeSpan.FromSeconds(30));
        // 获取键值
        string userName = db.StringGet("user:name");
        Console.WriteLine($"获取到的用户名：{userName}");
        // 自增操作
        db.StringSet("user:age", 20);
        long newAge = db.StringIncrement("user:age");
        Console.WriteLine($"自增后的年龄：{newAge}");
    }
}

哈希类型操作

哈希类型适合存储对象类数据，比如用户信息：

class RedisHashDemo
{
    public static void OperateHash()
    {
        var db = RedisHelper.GetConnection().GetDatabase();
        // 设置哈希字段
        db.HashSet("user:1001", "name", "李四");
        db.HashSet("user:1001", "age", 25);
        db.HashSet("user:1001", "email", "test@ipipp.com");
        // 获取单个字段
        string name = db.HashGet("user:1001", "name");
        Console.WriteLine($"用户姓名：{name}");
        // 获取所有哈希字段和值
        var allFields = db.HashGetAll("user:1001");
        foreach (var field in allFields)
        {
            Console.WriteLine($"{field.Name}:{field.Value}");
        }
    }
}

列表类型操作

列表类型可以实现队列、栈等数据结构：

class RedisListDemo
{
    public static void OperateList()
    {
        var db = RedisHelper.GetConnection().GetDatabase();
        // 从左侧添加元素
        db.ListLeftPush("task:queue", "任务1");
        db.ListLeftPush("task:queue", "任务2");
        db.ListLeftPush("task:queue", "任务3");
        // 从右侧取出元素，实现先进先出队列
        string task = db.ListRightPop("task:queue");
        Console.WriteLine($"取出的任务：{task}");
        // 获取列表所有元素
        var allTasks = db.ListRange("task:queue");
        Console.WriteLine("剩余任务：");
        foreach (var item in allTasks)
        {
            Console.WriteLine(item);
        }
    }
}

注意事项

• ConnectionMultiplexer是线程安全的，不要每次操作都创建新实例，避免连接资源浪费。
• 操作Redis时建议做好异常处理，比如连接超时、Redis服务不可用等情况要捕获RedisException。
• 如果项目使用异步编程，优先使用StackExchange.Redis提供的异步方法，比如StringSetAsync、StringGetAsync，避免阻塞主线程。
• 生产环境建议配置连接池相关参数，根据业务并发量调整连接数上限，提升性能。

C#StackExchange_RedisRedis连接Redis客户端数据库操作修改时间：2026-07-23 06:03:25