CA1051: Verklaar geen zichtbare exemplaarvelden

Oorzaak

Een type heeft een niet-privé-exemplaarveld.

Deze regel kijkt standaard alleen naar extern zichtbare typen, maar dit kan worden geconfigureerd.

Beschrijving van regel

Het primaire gebruik van een veld moet als een implementatiedetail zijn. Velden moeten zijn private of internal moeten worden weergegeven met behulp van eigenschappen. Het is net zo eenvoudig om toegang te krijgen tot een eigenschap als tot een veld, en de code in de accessoren van een eigenschap kan veranderen als de features van het type worden uitgebreid zonder brekende wijzigingen in te voeren.

Eigenschappen die alleen de waarde van een privé- of intern veld retourneren, zijn geoptimaliseerd om te worden uitgevoerd op basis van toegang tot een veld; de prestatiewinst van het gebruik van extern zichtbare velden in plaats van eigenschappen is minimaal. Extern zichtbaar verwijst naarpublic, protecteden (protected internalPublicen ProtectedProtected Friend in Visual Basic) toegankelijkheidsniveaus.

Daarnaast kunnen openbare velden niet worden beveiligd door koppelingsvereisten. (Koppelingsvereisten zijn niet van toepassing op .NET Core-apps.)

Hoe schendingen op te lossen

Als u een schending van deze regel wilt oplossen, maak het veld private of internal zichtbaar via een extern zichtbare property.

Wanneer waarschuwingen onderdrukken

Onderdrukt deze waarschuwing alleen als u zeker weet dat consumenten directe toegang tot het veld nodig hebben. Voor de meeste toepassingen bieden weergegeven velden geen prestatie- of onderhoudbaarheidsvoordelen ten opzichte van eigenschappen.

Consumenten hebben mogelijk veldtoegang nodig in de volgende situaties:

• In ASP.NET inhoudsbesturingselementen voor webformulieren.
• Wanneer het doelplatform gebruikmaakt van ref om velden te wijzigen, zoals MVVM-frameworks (model-view-viewmodel) voor WPF en UWP.

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

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

Zie voor meer informatie Hoe codeanalysewaarschuwingen te onderdrukken.

API's opnemen of uitsluiten

Gebruik de volgende opties om te configureren op welke onderdelen van uw codebase deze regel moet worden uitgevoerd.

• Specifieke API-oppervlakken opnemen
• Structs uitsluiten

U kunt deze opties configureren voor alleen deze regel, voor alle regels waarop ze van toepassing zijn, of voor alle regels in deze categorie (Ontwerp) waarop ze van toepassing zijn. Zie de configuratieopties voor de codekwaliteitsregel voor meer informatie.

Specifieke API-oppervlakken opnemen

U kunt configureren op welke onderdelen van uw codebase deze regel moet worden uitgevoerd, op basis van hun toegankelijkheid, door de optie api_surface in te stellen. Als u bijvoorbeeld wilt opgeven dat de regel alleen moet worden uitgevoerd op het niet-openbare API-oppervlak, voegt u het volgende sleutel-waardepaar toe aan een .editorconfig-bestand in uw project:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Structs uitsluiten

U kunt struct-velden (Structure in Visual Basic) uitsluiten van analyse.

dotnet_code_quality.ca1051.exclude_structs = true

Voorbeeld

In het volgende voorbeeld ziet u een type (BadPublicInstanceFields) dat deze regel schendt. GoodPublicInstanceFields geeft de gecorrigeerde code weer.

public class BadPublicInstanceFields
{
    // Violates rule DoNotDeclareVisibleInstanceFields.
    public int instanceData = 32;
}

public class GoodPublicInstanceFields
{
    public int InstanceData { get; set; } = 32;
}

Zie ook

• Koppelingsvereisten