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 9 | 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.
Opmerking
In het volgende voorbeeld ziet u een type, ViolatingBase
dat in strijd is met de regel en een type, FixedBase
waarin 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();
}
}