Share via


CA1833: AsSpan of AsMemory gebruiken in plaats van indexeerfuncties op basis van bereik voor het ophalen van span- of geheugengedeelte van een matrix

Eigenschappen Weergegeven als
Regel-id CA1833
Titel AsSpan of AsMemory gebruiken in plaats van op bereik gebaseerde indexeerfuncties voor het ophalen van span- of geheugengedeelte van een matrix
Categorie Prestaties
Oplossing is brekend of niet-brekend Niet-brekend
Standaard ingeschakeld in .NET 8 Als suggestie

Oorzaak

Wanneer u een bereikindexeerfunctie op een matrix gebruikt en impliciet de waarde toewijst aan Span<T> of Memory<T>.

Beschrijving van regel

De bereikindexeerfunctie op een Span<T> is een niet-kopieerbewerking Slice . Maar voor de bereikindexeerfunctie op een matrix wordt de methode GetSubArray gebruikt in plaats van Slice, die een kopie van het aangevraagde gedeelte van de matrix produceert. Deze kopie is meestal niet nodig wanneer deze impliciet wordt gebruikt als een Span<T> of Memory<T> meer waarden. Als een kopie niet is bedoeld, gebruikt u de AsSpan of AsMemory methode om onnodige kopie te voorkomen. Als de kopie is bedoeld, wijst u deze eerst toe aan een lokale variabele of voegt u een expliciete cast toe. De analyse rapporteert alleen wanneer een impliciete cast wordt gebruikt op het resultaat van de bereikindexeerbewerking.

Detecteert

Impliciete conversies:

  • Span<SomeT> slice = arr[a..b];
  • Memory<SomeT> slice = arr[a..b];

Detecteert niet

Expliciete conversies:

  • Span<SomeT> slice = (Span<SomeT>)arr[a..b];
  • Memory<SomeT> slice = (Memory<SomeT>)arr[a..b];

Schendingen oplossen

Als u een schending van deze regel wilt oplossen, gebruikt u de AsSpan of AsMemory extensiemethode om te voorkomen dat onnodige gegevenskopieën worden gemaakt.

class C
{
    public void TestMethod(byte[] arr)
    {
        // The violation occurs for both statements below
        Span<byte> tmp2 = arr[0..5];
        Memory<byte> tmp4 = arr[5..10];
        ...
    }
}
class C
{
    public void TestMethod(byte[] arr)
    {
        // The violations fixed with AsSpan or AsMemory accordingly
        Span<byte> tmp2 = arr.AsSpan()[0..5];
        Memory<byte> tmp4 = arr.AsMemory()[5..10];
        ...
    }
}

Tip

Er is een codeoplossing beschikbaar voor deze regel in Visual Studio. Als u deze wilt gebruiken, plaatst u de cursor op de schending en drukt u op Ctrl+. (punt). Kies AsMemory gebruiken in plaats van de op bereik gebaseerde indexeerfunctie op een matrix in de lijst met opties die worden weergegeven.

Code fix for CA1833 - Use AsSpan or AsMemory instead of Range-based indexers for getting Span or Memory portion of an array

U kunt deze waarschuwing ook vermijden door een expliciete cast toe te voegen.

class C
{
    public void TestMethod(byte[] arr)
    {
        // The violation occurs
        Span<byte> tmp1 = arr[0..5];
        Memory<byte> tmp2 = arr[5..10];
        ...
    }
}
class C
{
    public void TestMethod(byte[] arr)
    {
        // The violation fixed with explicit casting
        Span<byte> tmp1 = (Span<byte>)arr[0..5];
        Memory<byte> tmp2 = (Memory<byte>)arr[5..10];
        ...
    }
}

Wanneer waarschuwingen onderdrukken

Het is veilig om een schending van deze regel te onderdrukken als het maken van een kopie is bedoeld.

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

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.CA1833.severity = none

Zie Codeanalysewaarschuwingen onderdrukken voor meer informatie.

Zie ook