CA1857: parametresi en iyi performans için bir sabit bekler

Özellik	Değer
Kural Kimliği	CA1857
Başlık	parametresi en iyi performans için bir sabit bekler
Kategori	Performans
Hataya neden olan veya bozulmayan düzeltme	Hataya neden olmayan
.NET 9'da varsayılan olarak etkin	Uyarı olarak

Neden

ile ConstantExpectedAttributeaçıklama ekleyen bir parametreye geçersiz bir bağımsız değişken geçirilir.

Kural açıklaması

Bu kural, kodunuzda aşağıdaki konumları işaretler:

• özniteliğini kullanan ancak parametresini ile ConstantExpectedAttributeişaretlemeyen devralınan ConstantExpectedAttribute bir yöntem uygulayın.
• Özniteliğine sahip ConstantExpectedAttribute bir parametreye sabit olmayan bir bağımsız değişken geçirin.
• Özniteliğine sahip ConstantExpectedAttribute bir parametreye geçersiz bir sabit bağımsız değişken geçirin.
• Özniteliği olan ConstantExpectedAttribute bir parametreye sabit bir bağımsız değişken geçirin ve bağımsız değişken veya Max değerlerinin aralığının Min dışında.

İhlalleri düzeltme

Kodunuzu, aldığınız hata iletisiyle belirtilen şekilde düzeltin.

Örnek 1 (öznitelik bekleniyor)

Aşağıdaki kod parçacığı CA1857 ihlalini gösterir:

public interface I1<T>
{
    T M1(T operand1, [ConstantExpected] T operand2);
}

public class C1 : I1<int>
{
    public int M1(int operand1, int operand2) =>
        throw new NotImplementedException();
}

Aşağıdaki kod parçacığı ihlali düzeltir:

public interface I1<T>
{
    T M1(T operand1, [ConstantExpected] T operand2);
}

public class C1 : I1<int>
{
    public int M1(int operand1, [ConstantExpected] int operand2) =>
        throw new NotImplementedException();
}

Örnek 2 (sabit değil sabit)

Aşağıdaki kod parçacığı CA1857 ihlalini gösterir:

static void M1(int i) => M2(i);
static void M2([ConstantExpected] int i) { }

Aşağıdaki kod parçacığı ihlali düzeltir:

static void M1([ConstantExpected] int i) => M2(i);
static void M2([ConstantExpected] int i) { }

Örnek 3 (geçersiz sabit)

Aşağıdaki kod parçacığı CA1857 ihlalini gösterir:

static void M1() => M2((string)(object)20);
static void M2([ConstantExpected] string s) { }

Aşağıdaki kod parçacığı ihlali düzeltir:

static void M1() => M2("20");
static void M2([ConstantExpected] string s) { }

Örnek 4 (sabit sınır dışı)

Aşağıdaki kod parçacığı CA1857 ihlalini gösterir:

static void M1() => M2(5);
static void M2([ConstantExpected(Min = 3, Max = 4)] int i) { }

Aşağıdaki kod parçacığı ihlali düzeltir:

static void M1() => M2(4);
static void M2([ConstantExpected(Min = 3, Max = 4)] int i) { }

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

Performans önemli değilse, bu kuraldan gelen bir uyarıyı engellemek güvenlidir.

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 CA1857
// The code that's violating the rule is on this line.
#pragma warning restore CA1857

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

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

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