CA2014: Döngülerde stackalloc kullanmayın

Özellik	Değer
Kural Kimliği	CA2014
Başlık	Döngülerde stackalloc kullanmayın
Kategori	Güvenilirlik
Düzeltme bozucu ya da bozmayan olabilir	Kesintisiz
.NET 10'da varsayılan olarak etkin	Uyarı olarak
Geçerli diller	C#

Neden

Döngünün içinde C# stackalloc ifadesini kullanma.

Kural açıklaması

C# stackalloc ifadesi mevcut yığın karesinden bellek ayırır ve bu bellek, yöntem çağrısı sona erene kadar serbest bırakılmayabilir. Bir döngüde kullanılırsa stackalloc , yığın belleğinin tükenmesi nedeniyle yığın taşmalarına yol açabilir.

İhlalleri düzeltme

Tüm döngülerin dışına stackalloc ifadesini yöntem içinde taşıyın.

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;

        // ...
    }
}

Uyarıların ne zaman bastırılması gerekiyor?

İçeren döngü veya döngüler yalnızca sınırlı sayıda çağrıldığında uyarıyı bastırmak güvenli olabilir; böylece tüm stackalloc işlemlere ayrılan genel bellek miktarının görece küçük olduğu bilinir.

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

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

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

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

Bu kural kategorisinin tamamını devre dışı bırakmak için, kategorinin önem derecesini noneyapılandırma dosyasında olarak ayarlayın.

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

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Ayrıca bkz.

• Güvenilirlik kuralları