CA1857: Il parametro prevede una costante per ottenere prestazioni ottimali

Proprietà	valore
ID regola	CA1857
Title	Il parametro prevede una costante per ottenere prestazioni ottimali
Categoria	Prestazioni
Correzione che causa un'interruzione o un'interruzione	Nessuna interruzione
Abilitato per impostazione predefinita in .NET 8	Come avviso

Causa

Un argomento non valido viene passato a un parametro annotato con ConstantExpectedAttribute.

Descrizione regola

Questa regola contrassegna le posizioni nel codice in cui:

• Implementare un metodo ereditato che usa l'attributo ConstantExpectedAttribute ma non contrassegnare il parametro con ConstantExpectedAttribute.
• Passare un argomento non costante a un parametro con l'attributo ConstantExpectedAttribute .
• Passare un argomento costante non valido a un parametro con l'attributo ConstantExpectedAttribute .
• Passare un argomento costante a un parametro con l'attributo ConstantExpectedAttribute e l'argomento non è compreso nell'intervallo Min dei valori o Max .

Come correggere le violazioni

Correggere il codice come indicato dal messaggio di errore specifico ricevuto.

Esempio 1 (attributo previsto)

Il frammento di codice seguente mostra una violazione di CA1857:

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();
}

Il frammento di codice seguente corregge la violazione:

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();
}

Esempio 2 (costante non costante)

Il frammento di codice seguente mostra una violazione di CA1857:

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

Il frammento di codice seguente corregge la violazione:

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

Esempio 3 (costante non valida)

Il frammento di codice seguente mostra una violazione di CA1857:

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

Il frammento di codice seguente corregge la violazione:

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

Esempio 4 (costante non vincolata)

Il frammento di codice seguente mostra una violazione di CA1857:

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

Il frammento di codice seguente corregge la violazione:

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

Quando eliminare gli avvisi

Se le prestazioni non sono un problema, è possibile eliminare un avviso da questa regola.

Eliminare un avviso

Se si vuole eliminare una singola violazione, aggiungere direttive del preprocessore al file di origine per disabilitare e quindi riabilitare la regola.

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

Per disabilitare la regola per un file, una cartella o un progetto, impostarne la gravità none su nel file di configurazione.

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

Per altre informazioni, vedere Come eliminare gli avvisi di analisi del codice.