IDatabase.KeyExists(string key)
作用：检测Redis中指定key是否存在

• 返回 true：key存在
• 返回 false：key不存在

只要key存在就返回true，不限数据类型（String、List、Hash等所有类型通用）

/// <summary>
/// 判断缓存key是否存在
/// </summary>
/// <param name="key">缓存键名</param>
/// <returns>存在true，不存在false</returns>
private bool IsSet(string key)
{
    return db.KeyExists(key);
}

示例

string cacheKey = "user:1001";
if(IsSet(cacheKey))
{
    // key存在，直接读取缓存
    var user = Get<User>(cacheKey);
}
else
{
    // key不存在，查询数据库，然后写入Redis
    var user = QueryDbUser(1001);
    Set(cacheKey, user, 30);
}

1. 底层API：IDatabase.StringGet(key)，从Redis读取字符串类型数据，返回类型为 RedisValue
2. RedisValue.HasValue：判断该key是否存在、是否有数据
   • true：key存在；
   • false：key不存在
3. 读取到二进制数据后，需要反序列化，还原为原始对象
4. 不存在时返回 default(T)
   • 值类型(int/DateTime)：返回0、最小时间
   • 引用类型(class)：返回null

例子

using StackExchange.Redis;
using Newtonsoft.Json;
using System.Text;

/// <summary>
/// 根据Key读取缓存对象
/// </summary>
/// <typeparam name="T">目标对象类型</typeparam>
/// <param name="key">缓存键名</param>
/// <returns>存在返回对象；不存在返回default(T)</returns>
public T Get<T>(string key)
{
    // 从redis读取数据
    RedisValue rValue = db.StringGet(key);

    // 判断key不存在
    if (!rValue.HasValue)
    {
        return default(T);
    }

    // 二进制数据反序列化为实体
    T result = Deserialize<T>(rValue);
    return result;
}

/// <summary>
/// 反序列化：byte[] → T对象
/// </summary>
private T Deserialize<T>(byte[] serializedObject)
{
    if (serializedObject == null)
    {
        return default(T);
    }
    // byte数组转json字符串
    string json = Encoding.UTF8.GetString(serializedObject);
    // json转为目标实体
    return JsonConvert.DeserializeObject<T>(json);
}

/// <summary>
/// 对象序列化方法（和Set配套）
/// </summary>
private byte[] Serialize(object data)
{
    string json = JsonConvert.SerializeObject(data);
    return Encoding.UTF8.GetBytes(json);
}

注意

1. 类型隐式转换
   RedisValue 可以直接隐式转换成 byte[]，所以代码可以直接把 rValue 传入 Deserialize<T>(byte[])，编译器自动转换。
2. 读写配对流程

Set写入流程：实体 → Serialize → byte[] → Redis
Get读取流程：Redis → byte[] → Deserialize → 实体

3. 调用示例

// 示例1：读取自定义实体
var user = Get<User>("user_1001");

// 示例2：读取简单字符串
string text = Get<string>("msg");

// 示例3：读取数字
int count = Get<int>("visit_count");

1. 序列化与反序列化类型不一致
   存入时存 User，读取时用 Student，会触发Json反序列化报错。
2. default(T)容易忽略空判断

var model = Get<User>("key");
// 引用类型不存在时model=null，直接访问model.Name会空引用报错
if(model != null)
{

}

3. 编码统一
   存入、读取必须统一使用 Encoding.UTF8，否则乱码。

1. 底层调用 IDatabase.StringSet() 写入Redis字符串类型数据
2. 序列化逻辑：任意对象 → JSON字符串 → UTF8 Byte数组存入Redis
3. 反序列化逻辑：读取Byte数组 → JSON字符串 → 目标泛型对象
4. 返回值：true = 设置成功，false = 设置失败

需要引入命名空间

using StackExchange.Redis;
using Newtonsoft.Json;
using System.Text;

下面实例，使用Set，输入key，然后输入字节数组，然后输入过期时间。

/// <summary>
/// 写入Redis缓存
/// </summary>
/// <param name="key">缓存键</param>
/// <param name="data">任意对象</param>
/// <param name="cacheTime">过期时长【分钟】</param>
/// <returns>true成功 / false失败</returns>
private bool Set(string key, object data, int cacheTime)
{
    if (data == null)
    {
        return false;
    }
    byte[] entryBytes = Serialize(data);
    TimeSpan expiresIn = TimeSpan.FromMinutes(cacheTime);
    return db.StringSet(key, entryBytes, expiresIn);
}

/// <summary>
/// 对象序列化：object → byte[]
/// </summary>
private byte[] Serialize(object data)
{
    string json = JsonConvert.SerializeObject(data);
    return Encoding.UTF8.GetBytes(json);
}

/// <summary>
/// 根据Key读取缓存
/// </summary>
/// <typeparam name="T">目标类型</typeparam>
/// <param name="key">缓存键</param>
/// <returns>缓存不存在返回 default(T)</returns>
public T Get<T>(string key)
{
    RedisValue rValue = db.StringGet(key);
    if (!rValue.HasValue)
    {
        return default(T);
    }
    T result = Deserialize<T>(rValue);
    return result;
}

/// <summary>
/// 反序列化：byte[] → T对象
/// </summary>
private T Deserialize<T>(byte[] serializedObject)
{
    if (serializedObject == null)
    {
        return default(T);
    }
    string json = Encoding.UTF8.GetString(serializedObject);
    return JsonConvert.DeserializeObject<T>(json);
}

注意

1. 时间单位
   代码中 TimeSpan.FromMinutes(cacheTime) = 传入数字代表【分钟】
   如果你窗体调用时传入 Set(key,val,1000)，会设置缓存 1000分钟过期，不是秒！

之前窗体代码调用写了1000，这里是典型易错点。
如果想要传入秒，改成 TimeSpan.FromSeconds(cacheTime)

2. 依赖安装
   NuGet必须同时安装：

• StackExchange.Redis
• Newtonsoft.Json

2. 数据存储格式
   所有对象都会序列化为JSON二进制存入Redis；打开Redis客户端看到的值是标准JSON文本。
3. RedisValue 兼容
   db.StringGet(key) 返回 RedisValue，它可以直接隐式转为byte[]，所以可以直接传给Deserialize<T>。
4. 线程安全建议
   IConnectionMultiplexer 需要全局单例，不要每次读写Redis新建连接。

使用示例

// 写入（30分钟过期）
bool ok = Set("user:1001", new {Id = 1001, Name = "test"}, 30);

// 读取
var user = Get<dynamic>("user:1001");

// 读取实体类示例
// var model = Get<UserInfo>("user:1001");

建议

可以把这套方法连同Redis连接代码，全部抽离到独立 RedisHelper.cs 静态帮助类，不要写在窗体Form里面，实现业务解耦。

我们安装了redis后，redis是一个服务，相当于一个独立的程序，那么我们在C# WINFORM中使用它，就需要好像链接数据库一样链接它。

下面是配置它的连接字符串，放到了app.config里面

1. App.config 配置

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <connectionStrings>
    <!-- Redis连接字符串 -->
    <add name="RedisConnectionString" connectionString="127.0.0.1:6379"/>
    <!-- 简写方式 connectionString="localhost" 默认端口6379 -->
  </connectionStrings>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
  </startup>
</configuration>

连接字符串说明

• localhost / 127.0.0.1：本地Redis服务
• 默认端口 6379；非默认端口格式：127.0.0.1:6380
• 如果Redis设置密码，写法：127.0.0.1:6379,password=你的密码

2. Form1.cs 核心代码

所需NuGet包

StackExchange.Redis

需要引入命名空间

using StackExchange.Redis;
using System.Configuration;

public partial class Form1 : Form
{
    // Redis数据库操作对象
    private IDatabase db;
    // 读取配置文件连接字符串
    private string ConnectionString = ConfigurationManager.ConnectionStrings["RedisConnectionString"].ConnectionString;
    // 多路复用连接（官方推荐单例，volatile保证线程安全）
    private volatile IConnectionMultiplexer connection;

    public Form1()
    {
        InitializeComponent();
        // 创建连接
        connection = ConnectionMultiplexer.Connect(ConnectionString);
        // 获取默认0号数据库
        db = connection.GetDatabase();
    }

    private void button1_Click(object sender, EventArgs e)
    {
        // Set方法：写入缓存（key、value、过期秒数）
        bool res = Set(this.textBox1.Text, this.textBox2.Text, 1000);
        if (res)
        {
            MessageBox.Show("设置成功");
        }
        else
        {
            MessageBox.Show("设置失败");
        }
    }

    /// <summary>
    /// Redis写入字符串键值（简易封装）
    /// </summary>
    bool Set(string key, object data, int cacheTime)
    {
        if (string.IsNullOrEmpty(key)) return false;
        // 设置过期时间
        var expire = TimeSpan.FromSeconds(cacheTime);
        return db.StringSet(key, data.ToString(), expire);
    }
}

打开VS 创建一个winform项目，然后使用nuget 安装依赖包

安装依赖包

1. StackExchange.Redis
   .NET生态最主流的Redis客户端开源组件，用于和Redis服务通信。
   Github仓库：https://github.com/StackExchange/StackExchange/StackExchange.Redis
   Redis本身提供TCP协议，理论上可以手写Socket直接通信，但工业开发几乎都使用成熟第三方库。
2. Newtonsoft.Json（Json.NET）
   用于对象序列化，把任意对象转为JSON字符串，再转成字节数组存入Redis；读取时反向反序列化。
   必须通过NuGet安装，代码中JsonConvert.SerializeObject就是来自这个库。

Redis封装方法

// 写入缓存：存入对象，设置过期分钟
private bool Set(string key, object data, int cacheTime)
{
    if (data == null)
    {
        return false;
    }
    var entryBytes = Serialize(data);
    var expiresIn = TimeSpan.FromMinutes(cacheTime);
    return db.StringSet(key, entryBytes, expiresIn);
}

// 对象序列化：实体对象 → UTF8字节数组
private byte[] Serialize(object data)
{
    var json = JsonConvert.SerializeObject(data);
    return Encoding.UTF8.GetBytes(json);
}

下载地址

目前（2026年） Redis官方仅提供Linux原版安装包，Windows版本由微软归档维护（现已停止更新）

1. 官网（Linux版）：http://redis.io/download
2. Windows版Github仓库：https://github.com/MSOpenTech/redis/tags
3. 示例版本（win-3.2.100）：
   https://github.com/MicrosoftArchive/redis/releases/tag/win-3.2.100

解压后核心文件

CMD命令行启动Redis服务端

1. 打开CMD，切换到Redis解压目录

cd D:\Redis\Redis-x64-3.2.100

2. 启动命令（加载配置文件）

redis-server redis.windows.conf

启动成功标识：

• 运行模式：Running in standalone mode（单机模式）
• 默认端口：6379

缺陷：以该方式启动，关闭CMD窗口，Redis服务直接停止

安装为Windows系统服务

普通CMD启动不能后台常驻，可以安装成系统服务实现开机自启。

课程演示仅临时启动，该步骤仅作参考。

Redis连接与基础命令测试

1. 客户端连接命令

新开一个CMD，进入Redis目录执行：

redis-cli.exe -h 127.0.0.1 -p 6379

• -h：指定Redis服务IP（可填写局域网其他电脑IP实现远程连接）
• -p：指定端口号

2. 基础指令演示

# 设置键值
set key1 value1
# 获取键对应的值
get key1

# 不存在的key查询返回 (nil)
get kkkk

set ddd 123
get ddd

规则：

• set 需要同时传入【key】和【value】两个参数，缺少参数会报错
• 查询不存在的键，返回 (nil)

注意

1. Windows Redis 3.2版本非常老旧，生产环境不推荐使用Windows版Redis，建议使用Linux环境部署；
2. 远程连接Redis需要关闭防火墙、修改配置文件允许外部IP访问；
3. 服务端CMD窗口必须保持打开，客户端才能正常连接。

Redis基础定义

Redis 是一款开源、使用ANSI C语言编写、支持网络访问、同时支持内存存储与持久化的 Key-Value（键值）数据库 / 存储系统，提供多编程语言客户端API。

1. 属于NoSQL非关系型数据库；
2. 和 Memcached 同类，但功能更强，可以弥补 Memcached 的短板；
3. 常作为关系型数据库（MySQL等）的补充缓存方案。

支持的数据类型

• String：字符串类型
• List：双向链表
• Set：无序集合
• zset(sorted set)：有序集合
• Hash：哈希结构（类似Map）

Memcached 仅支持字符串，这是二者最典型的区别之一。

特性

1. 多语言客户端支持
   官方提供 Java、C/C++、C#、PHP、JavaScript、Python、Ruby、Perl 等大量语言SDK，开发接入便捷。
2. 主从同步机制
   支持主从复制，可以实现数据异地备份、读写分离，提升可用性。
3. 高性能
   数据优先存放内存，读写速度极高，广泛用作分布式缓存。
4. 持久化能力
   可将内存数据落地磁盘，重启后数据不会全部丢失（Memcached 默认无持久化）。

背景

早期Redis项目由VMware资助开发与维护。

我们会用 WinForm(C#) 简易Redis客户端Demo来给大家演示使用，是C#对接Redis的入门演示程序。

• 设置键值
• 根据键获取值
  

Redis vs Memcached 简要对比