与“.NET Framework”相关的文章 - 𝓍𝑜𝓎𝑜𝓏𝑜.𝓃𝑒𝓉

今天发现在 .NET Framework 和 .NET 9 中使用 System.Uri.EscapeDataString() 方法对字符串进行编码，会产生不同的结果。

譬如“(”符号，前者视其为非保留字符，不进行转义，后者视为保留字符，转义为“%28”。

原因是 .NET Framework 4.8 主要遵循 RFC 2396，而 .NET 9 遵循 RFC 3986。

在跨平台签名验证场景中，对 URL 编码的一致性要求极高，任何细微差别都会导致签名校验失败。

以下是以 RFC 3986 标准为核心、优先使用各平台内置的高一致性方案。

对于 .NET 9，直接使用 Uri.EscapeDataString()。

string encodedData = System.Uri.EscapeDataString(dataToEncode);

对于 .NET Framework，以下是一个遵循 RFC 3986 严格标准的自定义编码方法示例。

static string Rfc3986EscapeDataString(string input)
{
    // 定义 RFC 3986 中明确的未保留字符集（不编码）
    var unreservedChars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_.~";

    var result = new StringBuilder();
    byte[] data = Encoding.UTF8.GetBytes(input); // 统一转换为 UTF-8 字节

    foreach (byte b in data)
    {
        char currentChar = (char)b;
        // 如果是未保留字符，直接输出
        if (unreservedChars.IndexOf(currentChar) != -1)
        {
            result.Append(currentChar);
        }
        else
        {
            // 否则，进行百分号编码（%XX，大写）
            result.Append('%').Append(b.ToString("X2"));
        }
    }
    return result.ToString();
}

对于 PHP，直接使用内置的 rawurlencode() 函数。这个函数的设计初衷就是严格遵循 RFC 3986 标准。

$encoded_data = rawurlencode($data_to_encode);

对于 JavaScript，encodeURIComponent 函数严格遵循 RFC 3986 标准。

let encodedData = encodeURIComponent(dataToEncode);

重要提示：无论使用哪种语言，务必在编码前明确指定字符串使用 UTF-8 编码。编码不一致是导致乱码和签名失败最常见的原因之一。

xoyozo 11 天前

向基于 .NET Framework 框架开发的 Web 网站 POST 数据响应 405 Method Not Allowed

今天遇到一个向基于 .NET Framework 框架开发的 Web 网站 POST 数据响应 405 Method Not Allowed 的问题。

服务端接口地址是 https://***/api/abc/Default.aspx，

若请求 https://***/api/abc/Default.aspx 或 https://***/api/abc/ 则正常，

若请求 https://***/api/abc 就会出现这个问题。

原因可能是服务器可能返回 301 重定向到 https://***/api/abc/Default.aspx，

导致最终接口接受到的请求方法不是 POST 。

xoyozo 1 个月前

201

在 .NET Framework 中控制内存缓存（MemoryCache）实例的最大内存占用

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

基本定义与作用

功能：通过 cacheMemoryLimitMegabytes 可设置 MemoryCache 实例允许占用的最大内存（单位：MB）。若缓存数据超过此限制，系统会自动淘汰旧条目。
默认值：默认值为 0，表示缓存基于计算机的物理内存自动管理（例如根据可用内存动态调整）。

配置方式

通过配置文件（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);

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

注意事项

优先级规则：
若同时配置了 cacheMemoryLimitMegabytes 和 physicalMemoryLimitPercentage，系统会选择两者中较小的值作为限制。
分布式缓存兼容性：
此属性仅适用于进程内缓存（如 MemoryCache），若使用 Redis 等分布式缓存需通过其独立配置管理内存。
监控与调试：
建议结合性能计数器（如 ASP.NET Applications 类别下的 Cache Total Entries）或日志记录模块（参考 web.config 的 <system.diagnostics> 配置）监控实际内存占用。

应用场景示例

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

配置实现：

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

代码调用：

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

常见问题

Q：设置为 0 时缓存会无限制增长吗？
A：不会。此时缓存基于系统物理内存动态管理，通常上限为总内存的 70%-90%。
Q：如何验证配置已生效？
A：可通过 MemoryCache.GetCount() 统计条目数量，或使用性能监视器跟踪内存占用。

xoyozo 8 个月前

828

C# URL 编码方法对比

方法/工具	发布时间	所属框架	命名空间/依赖项	编码标准	空格处理	严格性	适用场景	现代项目支持（.NET 6+）
HttpUtility.UrlEncode	2002	.NET Framework 1.0+	System.Web（需引用 DLL）	x-www-form-urlencoded	+	宽松	传统 ASP.NET WebForms	❌
Server.UrlEncode	2002	.NET Framework 1.0+	System.Web（ASP.NET 页面内）	x-www-form-urlencoded	+	宽松	ASP.NET WebForms 页面内编码	❌
Uri.EscapeDataString	2005	.NET Framework 2.0+	System（核心库）	RFC 3986	%20	严格	构造 URI 组件（路径、查询参数）	✔️
WebUtility.UrlEncode	2012	.NET Framework 4.5+	System.Net（跨平台）	x-www-form-urlencoded	+	宽松	非 Web 环境或兼容旧代码	✔️
UrlEncoder.Default.Encode	2016	.NET Core 1.0+	System.Text.Encodings.Web	RFC 3986	%20	严格	现代应用，严格 URI 编码	✔️

关键选择原则

兼容旧代码 → HttpUtility.UrlEncode 或 WebUtility.UrlEncode。
严格 URI 规范 → Uri.EscapeDataString 或 UrlEncoder。
ASP.NET Core → UrlEncoder。
非 Web 或跨平台 → 弃用 System.Web，选择 System.Net 或 System.Text.Encodings.Web 中的方法。

xoyozo 8 个月前

939

.NET Core / .NET 5+ 实现每次发布自动更新版本号

打开 .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 实现自动版本号的方法

xoyozo 8 个月前

878

.NET Framework Web 窗体项目实现每次发布自动更新版本号

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

修改版本号格式

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

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

关闭确定性构建
用文本编辑器打开 .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+ 实现自动版本号的方法

xoyozo 8 个月前

678

Character set 'utf8mb3' is not supported by .Net Framework.

.NET Framework 项目中使用 MySql.Data.EntityFramework 连接 MySQL 8.0 时遇到以下错误：

NotSupportedException: Character set 'utf8mb3' is not supported by .Net Framework.

解决方法：

Nuget 中将 MySql.Data 和 MySql.Data.EntityFramework 更新到最新版。

xoyozo 2 年前

1,750

未能找到路径“\roslyn\csc.exe”的一部分。

解决方法：

在 nuget 中直接卸载 Microsoft.CodeDom.Providers.DotNetCompilerPlatform

如果 web.config 报错，删除与 Microsoft.CodeDom.Providers.DotNetCompilerPlatform 相关的项，如：

<system.codedom>
	<compilers>
		<compiler language="c#;cs;csharp" extension=".cs" warningLevel="4" compilerOptions="/langversion:default /nowarn:1659;1699;1701;612;618" type="Microsoft.CodeDom.Providers.DotNetCompilerPlatform.CSharpCodeProvider, Microsoft.CodeDom.Providers.DotNetCompilerPlatform, Version=4.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
		<compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" warningLevel="4" compilerOptions="/langversion:default /nowarn:41008,40000,40008 /define:_MYTYPE=\&quot;Web\&quot; /optionInfer+" type="Microsoft.CodeDom.Providers.DotNetCompilerPlatform.VBCodeProvider, Microsoft.CodeDom.Providers.DotNetCompilerPlatform, Version=4.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
	</compilers>
</system.codedom>

然后遇到错误：

功能 空传播运算符 在 C# 5 中不可用。请使用 6 或更高的语言版本

所以还是少不了 Microsoft.CodeDom.Providers.DotNetCompilerPlatform

又把这货装上了，竟然不报错了。

这期间我更改过在 Release 模式下调试，将 .NET Framework 4.8 升级到 .NET Framework 4.8.1 等，然后又退回到原来的状态和版本，竟然都正常了。

就这样吧！

xoyozo 2 年前

2,027

无法执行程序。所执行的命令为 "\bin\roslyn\csc.exe"

System.ComponentModel.Win32Exception: 拒绝访问。

[ExternalException (0x80004005): 无法执行程序。所执行的命令为 "\bin\roslyn\csc.exe" /shared /keepalive:"10" /noconfig  /fullpaths @"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files\root\8c8f68eb\880f02b5\alczcu1a.cmdline"。]

解决方法：

web 部署发布时勾选“在发布期间预编译”