CA1044: Vlastnosti by neměly být pouze pro zápis

Vlastnost	Hodnota
ID pravidla	CA1044
Název	Vlastnosti by neměly být pouze pro zápis
Kategorie	Návrh
Oprava způsobující chybu nebo chybu způsobující chybu	Narušující
Povoleno ve výchozím nastavení v .NET 8	No

Příčina

Vlastnost má nastavený přístupový objekt, ale ne přístupový objekt get.

Ve výchozím nastavení toto pravidlo sleduje jenom externě viditelné typy, ale dá se konfigurovat.

Popis pravidla

Přístupové objekty Get poskytují přístup pro čtení k vlastnosti a nastavení přístupových objektů poskytují přístup k zápisu. Ačkoli je přijatelné a často nezbytné použít vlastnost jen pro čtení, směrnice návrhu zakazují použití vlastností jen pro zápis. Důvodem je to, že když necháte uživatele nastavit hodnotu a pak zabráníte uživateli v zobrazení hodnoty, neposkytuje žádné zabezpečení. Taktéž bez přístupu pro čtení není možné zobrazit stav sdílených objektů, což omezuje jejich užitečnost.

Jak opravit porušení

Chcete-li opravit porušení tohoto pravidla, přidejte přístup k vlastnosti get. Případně pokud je potřeba chování vlastnosti jen pro zápis, zvažte převod této vlastnosti na metodu.

Kdy potlačit upozornění

Doporučujeme nepotlačit upozornění z tohoto pravidla.

Konfigurace kódu pro analýzu

Pomocí následující možnosti nakonfigurujte, ve kterých částech základu kódu se má toto pravidlo spouštět.

• Zahrnutí konkrétních povrchů rozhraní API

Tuto možnost můžete nakonfigurovat jenom pro toto pravidlo, pro všechna pravidla, která platí, nebo pro všechna pravidla v této kategorii (Návrh), na která platí. Další informace naleznete v tématu Možnosti konfigurace pravidla kvality kódu.

Zahrnutí konkrétních povrchů rozhraní API

Na základě přístupnosti můžete nakonfigurovat, na kterých částech základu kódu se má toto pravidlo spouštět. Pokud chcete například určit, že pravidlo by se mělo spouštět jenom na neveřejné ploše rozhraní API, přidejte do souboru .editorconfig v projektu následující pár klíč-hodnota:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Příklad

V následujícím příkladu BadClassWithWriteOnlyProperty je typ s vlastností jen pro zápis. GoodClassWithReadWriteProperty obsahuje opravený kód.

Imports System

Namespace ca1044

    Public Class BadClassWithWriteOnlyProperty

        Dim someName As String

        ' Violates rule PropertiesShouldNotBeWriteOnly.
        WriteOnly Property Name As String
            Set
                someName = Value
            End Set
        End Property

    End Class

    Public Class GoodClassWithReadWriteProperty

        Property Name As String

    End Class

End Namespace

public class BadClassWithWriteOnlyProperty
{
    string? _someName;

    // Violates rule PropertiesShouldNotBeWriteOnly.
    public string? Name
    {
        set
        {
            _someName = value;
        }
    }
}

public class GoodClassWithReadWriteProperty
{
    public string? Name { get; set; }
}