C#自定义简化Cookie类实例

背景与目标

在ASP.NET Web开发中，直接操作 HttpCookie 和 HttpContext 往往需要重复编写样板代码。为了方便使用，可以将其封装为一个静态工具类，提供统一的接口来执行常见操作，如安全地读写数据和管理生命周期。

准备条件

• 运行环境：.NET Framework 或支持 System.Web 的 .NET Core/5+ 项目（注：在较新的 ASP.NET Core 项目中，Cookie 管理方式有所不同，以下示例主要针对传统 ASP.NET Web Forms/MVC）。
• 命名空间引用：需确保引入了 System 和 System.Web 命名空间。

实现步骤

第1步：定义工具类结构

创建一个名为 CookieHelper 的静态类，位于 DotNet.Utilities 命名空间下，便于全局调用。

第2步：实现清除Cookie方法

通过修改过期时间为过去的时间点来触发浏览器删除机制。注意处理空引用情况：

using System;
using System.Web;

namespace DotNet.Utilities
{
 public class CookieHelper
 {
  /// <summary>
  /// 清除指定Cookie
  /// </summary>
  public static void ClearCookie(string cookiename)
  {
   HttpCookie cookie = HttpContext.Current.Request.Cookies[cookiename];
   if (cookie != null)
   {
    cookie.Expires = DateTime.Now.AddYears(-3);
    HttpContext.Current.Response.Cookies.Add(cookie);
   }
  }
 // ... 其他方法省略 ...
 } 
}

第3步：实现获取Cookie值方法

安全地从请求中读取指定键的值，若不存在则返回空字符串：

  /// <summary>
  /// 获取指定Cookie值
  /// </summary>
  public static string GetCookieValue(string cookiename)
  {
   HttpCookie cookie = HttpContext.Current.Request.Cookies[cookiename];
   string str = string.Empty;
   if (cookie != null)
   {
    str = cookie.Value;
   }
   return str;
  }

第4步：实现设置Cookie方法

提供两个重载版本：一个默认24小时过期，另一个允许自定义时间。建议使用显式创建 HttpCookie 对象以控制更精细的属性：

  /// <summary>
  /// 添加一个Cookie（24小时过期）
  /// </summary>
  public static void SetCookie(string cookiename, string cookievalue)
  {
   SetCookie(cookiename, cookievalue, DateTime.Now.AddDays(1.0));
  }

  /// <summary>
  /// 添加一个Cookie
  /// </summary>
  public static void SetCookie(string cookiename, string cookievalue,DateTime expires)
  {
   HttpCookie cookie = new HttpCookie(cookiename)
   {
    Value = cookievalue,
    Expires = expires
   };
   HttpContext.Current.Response.Cookies.Add(cookie);
  }
 }

完成判断

编译无错误，并在Controller或页面代码中尝试调用 CookieHelper.SetCookie(