CA1033: Interfacemethoden moeten kunnen worden aangeroepen door onderliggende typen

Eigenschappen	Weergegeven als
Regel-id	CA1033
Titel	Interfacemethoden moeten kunnen worden aangeroepen door onderliggende typen
Categorie	Ontwerpen
Oplossing is brekend of niet-brekend	Niet-brekend
Standaard ingeschakeld in .NET 8	Nee

Oorzaak

Een niet-verzegeld extern zichtbaar type biedt een expliciete methode-implementatie van een openbare interface en biedt geen alternatieve extern zichtbare methode met dezelfde naam.

Beschrijving van regel

Overweeg een basistype dat expliciet een openbare interfacemethode implementeert. Een type dat is afgeleid van het basistype, heeft alleen toegang tot de overgenomen interfacemethode via een verwijzing naar het huidige exemplaar (this in C#) dat naar de interface wordt gecast. Als het afgeleide type opnieuw wordt gebruikt (expliciet) de overgenomen interfacemethode, kan de basis-implementatie niet meer worden geopend. De aanroep via de verwijzing naar het huidige exemplaar roept de afgeleide implementatie aan; dit veroorzaakt recursie en een uiteindelijke stack-overloop.

Deze regel rapporteert geen schending voor een expliciete implementatie van System.IDisposable.Dispose wanneer er een extern zichtbare Close() methode wordt System.IDisposable.Dispose(Boolean) opgegeven.

Schendingen oplossen

Als u een schending van deze regel wilt oplossen, implementeert u een nieuwe methode die dezelfde functionaliteit beschikbaar maakt en zichtbaar is voor afgeleide typen of wijzigingen in een nonexplicit-implementatie. Als een wijziging die fouten veroorzaken acceptabel is, is een alternatief om het type verzegeld te maken.

Wanneer waarschuwingen onderdrukken

Het is veilig om een waarschuwing van deze regel te onderdrukken als er een extern zichtbare methode wordt opgegeven die dezelfde functionaliteit heeft, maar een andere naam heeft dan de expliciet geïmplementeerde methode.

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

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

Zie Codeanalysewaarschuwingen onderdrukken voor meer informatie.

Voorbeeld

In het volgende voorbeeld ziet u een type, ViolatingBasedat in strijd is met de regel en een type, FixedBasewaarin een oplossing voor de schending wordt weergegeven.

public interface ITest
{
    void SomeMethod();
}

public class ViolatingBase : ITest
{
    void ITest.SomeMethod()
    {
        // ...
    }
}

public class FixedBase : ITest
{
    void ITest.SomeMethod()
    {
        SomeMethod();
    }

    protected void SomeMethod()
    {
        // ...
    }
}

sealed public class Derived : FixedBase, ITest
{
    public void SomeMethod()
    {
        // The following would cause recursion and a stack overflow.
        // ((ITest)this).SomeMethod();

        // The following is unavailable if derived from ViolatingBase.
        base.SomeMethod();
    }
}

Zie ook

• Interfaces