通过


CA2014:请勿在循环中使用 stackalloc

属性
规则 ID CA2014
标题 请勿在循环中使用 stackalloc
类别 可靠性
修复是导致破坏性更改还是非破坏性更改 非中断
在 .NET 10 中默认启用 作为警告
适用的语言 C#

原因

在循环中使用 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

有关详细信息,请参阅如何禁止显示代码分析警告

另请参阅