| 属性 | 值 |
|---|---|
| 规则 ID | CA2014 |
| 标题 | 请勿在循环中使用 stackalloc |
| 类别 | 可靠性 |
| 修复是中断修复还是非中断修复 | 非中断 |
| 在 .NET 9 中默认启用 | 作为警告 |
原因
在循环中使用 C# stackalloc 表达式。
规则说明
C# stackalloc 表达式从当前堆栈帧分配内存,并且在当前方法调用返回之前,不能释放内存。 如果在循环中使用 stackalloc,则可能会由于耗尽堆栈内存而导致堆栈溢出。
如何解决冲突
将 stackalloc 表达式移动到方法中的所有循环之外。
Example
// This method violates the rule.
public void ProcessDataBad()
{
for (int i = 0; i < 100; i++)
{
// CA2014: Potential stack overflow.
// Move the stackalloc out of the loop.
Span<int> buffer = stackalloc int[100];
buffer[0] = i;
// ...
}
}
// This method satisfies the rule.
public void ProcessDataGood()
{
Span<int> buffer = stackalloc int[100];
for (int i = 0; i < 100; i++)
{
buffer[0] = i;
// ...
}
}
何时禁止显示警告
如果包含的循环仅被调用有限的次数,使得在所有 stackalloc 操作中分配的总内存量相对较小时,可能可以禁止显示此规则的冲突警告。
抑制警告
如果只想抑制单个冲突,请将预处理器指令添加到源文件以禁用该规则,然后重新启用该规则。
#pragma warning disable CA2014
// The code that's violating the rule is on this line.
#pragma warning restore CA2014
若要对文件、文件夹或项目禁用该规则,请在none中将其严重性设置为 。
[*.{cs,vb}]
dotnet_diagnostic.CA2014.severity = none
若要禁用此整个规则类别,请在none中将此类别的严重性设置为 。
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Reliability.severity = none
有关详细信息,请参阅如何禁止显示代码分析警告。