CSRedis安装与配置指南

白威东

于 2025-04-15 11:50:00 发布

阅读量611

点赞数 23

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00183/article/details/147246560

CSRedis安装与配置指南

csredis .NET client for Redis and Redis Sentinel (2.8). Includes both synchronous and asynchronous clients. 项目地址: https://gitcode.com/gh_mirrors/csr/csredis

1. 项目基础介绍

CSRedis 是一个 .NET 客户端，用于与 Redis 和 Redis Sentinel (2.8.12) 进行交互。它提供了同步和异步的实现方式，使得.NET应用能够便捷地使用 Redis 的各种特性。

本项目主要使用的编程语言是 C#。

2. 关键技术和框架

Redis：一个开源的 in-memory 数据结构存储系统，用作数据库、缓存和消息代理。
Redis Sentinel：Redis 的高可用性解决方案，用于管理多个 Redis 节点，并在主节点故障时自动故障转移。
.NET：一个开源的、跨平台的开发框架，用于构建各种应用程序。

3. 安装和配置

准备工作

在开始安装之前，请确保您的开发环境中已经安装了以下内容：

.NET SDK
Redis 服务器（本地或远程）

安装步骤

通过 NuGet 安装 CSRedis

最简单的安装方式是使用 NuGet 包管理器：

Install-Package csredis

基本使用

以下是一个基本的使用示例：

using (var redis = new RedisClient("yourhost"))
{
    string ping = redis.Ping();
    string echo = redis.Echo("hello world");
    DateTime time = redis.Time();
}

异步命令

CSRedis 也支持异步命令：

using (var redis = new RedisClient("localhost"))
{
    // 异步自增
    redis.IncrAsync("test1");

    // 异步获取时间，并在结果准备好后打印
    redis.TimeAsync().ContinueWith(t => Console.WriteLine(t.Result));

    // 阻塞调用
    string result = redis.GetAsync("test1").Result;
}

管道化

CSRedis 支持管道化命令，以减少网络开销：

using (var redis = new RedisClient("localhost"))
{
    redis.StartPipe();
    var empty1 = redis.Echo("hello");
    var empty2 = redis.Time();
    object[] result = redis.EndPipe();
    
    var item1 = (string)result[0];
    var item2 = (DateTime)result[1];
}

认证和重连

CSRedis 支持密码认证和自动重连：

using (var redis = new RedisClient("localhost"))
{
    redis.Auth("mystrongpasword");
    
    redis.Connected += (s, e) => redis.Auth(redis.Password);
    redis.ReconnectAttempts = 3;
    redis.ReconnectWait = 200;
}

散列映射

CSRedis 支持将任何 POCO 或匿名对象传递给泛型散列方法。

redis.HMSet("myhash", new
{
    Field1 = "string",
    Field2 = true,
    Field3 = DateTime.Now,
});

事务

同步事务通过 API 调用 MULTI/EXEC/DISCARD 来处理。

redis.TransactionQueued += (s, e) =>
{
    Console.WriteLine($"Transaction queued: {e.Command}({String.Join(", ", e.Arguments)}) = {e.Status}");
};
redis.Multi();
redis.Set("test1", "hello");
redis.Set("test2", "world");
object[] result = redis.Exec();