博客 (635)

在 .NET Framework 的缓存管理中，cacheMemoryLimitMegabytes 是一个关键配置属性，用于控制内存缓存（MemoryCache）实例的最大内存占用。以下是其具体用法及实现细节：

1. 基本定义与作用

• 功能：通过 cacheMemoryLimitMegabytes 可设置 MemoryCache 实例允许占用的最大内存（单位：MB）。若缓存数据超过此限制，系统会自动淘汰旧条目。

• 默认值：默认值为 0，表示缓存基于计算机的物理内存自动管理（例如根据可用内存动态调整）。
  

2. 配置方式

• 通过配置文件（web.config）

  在 web.config 的 <system.runtime.caching> 节点下配置 namedCaches，示例：

  <configuration>
    <system.runtime.caching>
      <memoryCache>
        <namedCaches>
          <add 
            name="Default" 
            cacheMemoryLimitMegabytes="500" 
            physicalMemoryLimitPercentage="50" 
            pollingInterval="00:05:00" />
        </namedCaches>
      </memoryCache>
    </system.runtime.caching>
  </configuration>

  参数说明：
  

• cacheMemoryLimitMegabytes：最大内存限制（例如 500 表示 500MB）。

• physicalMemoryLimitPercentage：允许使用的物理内存百分比（可选）。

• pollingInterval：缓存清理策略的轮询间隔（例如每5分钟检查一次）。

• 通过代码动态配置

  在初始化 MemoryCache 时，通过 NameValueCollection 传递参数：

  var config = new NameValueCollection
  {
      { "cacheMemoryLimitMegabytes", "500" },
      { "physicalMemoryLimitPercentage", "50" },
      { "pollingInterval", "00:05:00" }
  };
  var cache = new MemoryCache("CustomCache", config);

  此方式适用于需要动态调整缓存策略的场景。

3. 注意事项

• 优先级规则：

  若同时配置了 cacheMemoryLimitMegabytes 和 physicalMemoryLimitPercentage，系统会选择两者中较小的值作为限制。
  

• 分布式缓存兼容性：

  此属性仅适用于进程内缓存（如 MemoryCache），若使用 Redis 等分布式缓存需通过其独立配置管理内存。
  

• 监控与调试：

  建议结合性能计数器（如 ASP.NET Applications 类别下的 Cache Total Entries）或日志记录模块（参考 web.config 的 <system.diagnostics> 配置）监控实际内存占用。
  

4. 应用场景示例

   场景：一个电商网站需要缓存商品目录数据，限制最大内存为 1GB。

   配置实现：

   <add 
     name="ProductCatalogCache" 
     cacheMemoryLimitMegabytes="1024" 
     pollingInterval="00:10:00" />

   代码调用：
   

   var productCatalog = MemoryCache.Default["ProductCatalog"];

5. 常见问题

1. Q：设置为 0 时缓存会无限制增长吗？

   A：不会。此时缓存基于系统物理内存动态管理，通常上限为总内存的 70%-90%。

2. Q：如何验证配置已生效？

   A：可通过 MemoryCache.GetCount() 统计条目数量，或使用性能监视器跟踪内存占用。
   

关键选择原则

• 兼容旧代码 → HttpUtility.UrlEncode 或 WebUtility.UrlEncode。

• 严格 URI 规范 → Uri.EscapeDataString 或 UrlEncoder。

• ASP.NET Core → UrlEncoder。

• 非 Web 或跨平台 → 弃用 System.Web，选择 System.Net 或 System.Text.Encodings.Web 中的方法。

设置缩放级别：

map.centerAndZoom(new T.LngLat(108.95, 34.27), 4); // 默认显示整个中国地图、省级边界线
map.setMinZoom(2); // 世界地图
map.setMaxZoom(8); // 区/县/市

1. 打开“任务计划程序”（taskschd.msc）

   

2. 点击右侧“创建任务”

   
   

3. 填写“名称”

   
   

4. “安全选项”根据实际情况设置

   如果选择“不管用户是否登录都要运行”，则启动成功后不会显示窗口（任务管理器中可见进程）

   如果选择“只在用户登录时运行”启动成功后会显示窗口，但系统重启后需要进入系统才能运行此计划

5. “触发器”新建，勾选“重复任务间隔”选最短，“持续时间”无限期，并取消“任务的执行时间超过此值则停止执行”

   
   

6. “操作”新建，启动程序，浏览程序或脚本

   
   

7. “设置”请勿启动新实例（只判断它启动的实例，不判断手动打开的或开机启动的实例），其它选项按需设置

   

8. 设置完成

   
   

打开 .csproj 项目文件，在 <PropertyGroup> 标签内添加：

<Version>
  1.0.$([System.Math]::Floor($([System.DateTime]::Now.Subtract($([System.DateTime]::Parse('2000-01-01T00:00:00Z'))).TotalDays))).$([MSBuild]::Divide($([System.Math]::Floor($([System.DateTime]::Now.TimeOfDay.TotalSeconds))), 2))
</Version>

最终生成的版本号示例： 1.0.9238.28518

其中，Major 与 Minor 是固定的，Build 是2000年1月1日至今的天数，Revision 是今天的秒数 / 2 所得的值。（为了防止数值超过 65535）

程序中获取版本号：

var version = Assembly.GetExecutingAssembly().GetName().Version!; // 当前类库
var version = Assembly.GetEntryAssembly()?.GetName().Version!; // 入口项目

从版本号获取发布时间：

DateTime versionTime = new DateTime(2000, 1, 1).AddDays(version.Build).AddSeconds(version.Revision * 2);

查看 .NET Framework 实现自动版本号的方法

1. 在解决方案资源管理器中找到 Properties/AssemblyInfo.cs 文件。该文件存放程序集版本信息。

2. 修改版本号格式

   将以下代码片段中的 AssemblyVersion 改为使用星号通配符（建议保留主版本和次版本号）：

   [assembly: AssemblyVersion("1.0.*")]  // 自动生成构建号和修订号
   // [assembly: AssemblyFileVersion("1.0.0.0")] // 注释或删除此行

3. 关闭确定性构建

   用文本编辑器打开 .csproj 项目文件，在 <PropertyGroup> 标签内添加：

   <Deterministic>false</Deterministic>

   此设置允许 MSBuild 生成动态版本号。

最终生成的版本号示例： 1.0.9238.28518

其中，Major 与 Minor 是固定的，Build 是2000年1月1日至今的天数，Revision 是今天的秒数 / 2 所得的值。（为了防止数值超过 65535）

程序中获取版本号：

var version = Assembly.GetExecutingAssembly().GetName().Version;

从版本号获取发布时间：

DateTime versionTime = new DateTime(2000, 1, 1).AddDays(version.Build).AddSeconds(version.Revision * 2);

查看 .NET Core / .NET 5+ 实现自动版本号的方法

通常，我们在更新一条数据库记录时，EF 先取出这一条记录：

var log = DbContext.MyTable.Find(id);

然后赋值字段并保存：

log.Result = "OK";
DbContext.SaveChanges();

这样就会产生两次数据库查询。

我们尝试用 Attach 方法。

先创建一个仅包含主键的对象：

var log  = new MyTable { Id = id };

将对象附加到上下文：

DbContext.MyTable.Attach(log);

然后更新需要更新的字段：

log.Result = "OK";
DbContext.SaveChanges();

这样，能在保留其它字段值的前提下，减少一次数据库查询。

但是需要注意的是：

当某非 null 字段需要恢复默认值时，EF 会忽略这个更改。（可能会因 EF 版本等原因有不同的结论）

举个例子：

某记录有个 int 型字段 a，在数据库中这个记录的 a 的值为 1，但 C# 中 int 型的默认值为 0，所以当 Attach 附加这个对象后，如果重新设置 log.a 为 0，那么保存后 a 的值仍为 1。

还有一种写法，利用 ExecuteUpdate 方法：

var affectedRows = DbContext.MyTable
  .Where(c => c.Id == id)
  .ExecuteUpdate(setters => setters
    .SetProperty(c => c.Result, "OK")
  );

返回匹配的行数。

这种写法不会遇到“恢复为默认值不生效”的问题，推荐使用。

Tea.TeaException:“code: 400, Specified parameter Version is not valid. request id: ”

可能是 AlibabaCloud.OpenApiClient.Models.Config 的 Endpoint 配置错误。

Tea.TeaException:“code: 400, The parameter IpProtocol must be specified with case insensitive TCP, UDP, ICMP, GRE or All. request id: ”

必须指定 Permissions 参数。参考文档

Tea.TeaException:“code: 403, User not authorized to operate on the specified resource, or this API doesn't support RAM. request id: ”

前往 RAM 访问控制配置用户的权限。

Tea.TeaException:“code: 401, The specified security group is not authorized to operate. request id: ”

没有权限操作当前安全组。或者检查安全组的实例 ID 是否正确。

本文不定期更新。

1. 命令提示符

   打开记事本，粘贴下方命令，保存为 .bat 文件

   @echo off
   iisreset
   pause

2. 命令提示符（管理员）

   打开记事本，粘贴下方命令，保存为 .bat 文件

   @echo off
   if not "%1"=="admin" (powershell start -verb runas '%0' admin & exit)
   iisreset
   pause

3. PowerShell

   创建一个快捷方式，目标为

   C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe -Command "Start-Process PowerShell -ArgumentList 'iisreset' -Verb RunAs"