Delen via

CA1832: AsSpan of AsMemory gebruiken in plaats van op range gebaseerde indexeerfuncties voor het ophalen van ReadOnlySpan of ReadOnlyMemory-gedeelte van een matrix

  • Artikel
Eigenschappen Weergegeven als
Regel-id CA1832
Titel AsSpan of AsMemory gebruiken in plaats van op range gebaseerde indexeerfuncties voor het ophalen van readOnlySpan of ReadOnlyMemory-gedeelte van een matrix
Categorie Prestaties
Oplossing is brekend of niet-brekend Niet-brekend
Standaard ingeschakeld in .NET 9 Als suggestie

Oorzaak

Wanneer u een bereikindexeerfunctie op een matrix gebruikt en impliciet de waarde toewijst aan ReadOnlySpan<T> of ReadOnlyMemory<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 ReadOnlySpan<T> of ReadOnlyMemory<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:

  • ReadOnlySpan<SomeT> slice = arr[a..b];
  • ReadOnlyMemory<SomeT> slice = arr[a..b];

Detecteert niet

Expliciete conversies:

  • ReadOnlySpan<SomeT> slice = (ReadOnlySpan<SomeT>)arr[a..b];
  • ReadOnlyMemory<SomeT> slice = (ReadOnlyMemory<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
        ReadOnlySpan<byte> tmp1 = arr[0..2];
        ReadOnlyMemory<byte> tmp3 = arr[5..8];
        ...
    }
}

class C
{
    public void TestMethod(byte[] arr)
    {
        // The violations fixed with AsSpan or AsMemory accordingly
        ReadOnlySpan<byte> tmp1 = arr.AsSpan()[0..2];
        ReadOnlyMemory<byte> tmp3 = arr.AsMemory()[5..8];
        ...
    }
}

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 AsSpan gebruiken in plaats van de op bereik gebaseerde indexeerfunctie op een matrix in de lijst met opties die worden weergegeven.

Codefix voor CA1832 - AsSpan of AsMemory gebruiken in plaats van op Range gebaseerde indexeerfuncties voor het ophalen van ReadOnlySpan of ReadOnlyMemory-gedeelte van een matrix

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

class C
{
    public void TestMethod(byte[] arr)
    {
        // The violation occurs
        ReadOnlySpan<byte> tmp1 = arr[0..2];
        ReadOnlyMemory<byte> tmp3 = arr[5..8];
        ...
    }
}

class C
{
    public void TestMethod(byte[] arr)
    {
        // The violation fixed with explicit casting
        ReadOnlySpan<byte> tmp1 = (ReadOnlySpan<byte>)arr[0..2];
        ReadOnlyMemory<byte> tmp3 = (ReadOnlyMemory<byte>)arr[5..8];
        ...
    }
}

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

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

Zie Codeanalysewaarschuwingen onderdrukken voor meer informatie.

Zie ook