CA2014: Gebruik stackalloc niet in lussen

Oorzaak

Gebruik de C# stackalloc-expressie binnen een lus.

Beschrijving van regel

De C# stackalloc -expressie wijst geheugen toe vanuit het huidige stackframe en dat geheugen wordt mogelijk pas vrijgegeven als de huidige methode-aanroep terugkeert. Als stackalloc in een lus wordt gebruikt, kan dit leiden tot stack-overloop vanwege uitputting van het stackgeheugen.

Hoe schendingen op te lossen

Verplaats de stackalloc expressie buiten alle lussen in de methode.

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;

        // ...
    }
}

Wanneer waarschuwingen onderdrukken

Het is mogelijk veilig om de waarschuwing te onderdrukken wanneer de betreffende lus of lussen slechts een eindig aantal keren worden aangeroepen, zodat de totale hoeveelheid geheugen die voor alle stackalloc bewerkingen is toegewezen, relatief klein is.

Een waarschuwing onderdrukken

Als u slechts één schending wilt onderdrukken, voegt u preprocessorrichtlijnen toe aan uw bronbestand om de regel uit te schakelen en vervolgens opnieuw in te schakelen.

#pragma warning disable CA2014
// The code that's violating the rule is on this line.
#pragma warning restore CA2014

Als u de regel voor een bestand, map of project wilt uitschakelen, stelt u de ernst none ervan in op het configuratiebestand.

[*.{cs,vb}]
dotnet_diagnostic.CA2014.severity = none

Als u deze hele categorie regels wilt uitschakelen, stelt u de ernst voor de categorie none in op in het configuratiebestand.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Reliability.severity = none

Zie voor meer informatie Hoe codeanalysewaarschuwingen te onderdrukken.

Zie ook

• Betrouwbaarheidsregels