将结构字段设置为可写 (IDE0064)

属性
规则 ID IDE0064
标题 将结构字段设置为可写
类别 CodeQuality
Subcategory 语言规则(修饰符首选项)
适用的语言 C#

概述

此规则检测包含一个或多个 readonly 字段的结构,还包含在构造函数之外对 this 的赋值。 此规则建议将 readonly 字段转换为非只读,即可写。 将此类结构字段标记为 readonly 可能会导致意外的行为,因为在构造函数之外对 this 赋值时,分配给该字段的值可能会发生更改。

选项

此规则没有关联的代码样式选项。

示例

// Code with violations
struct MyStruct
{
    public readonly int Value;

    public MyStruct(int value)
    {
        Value = value;
    }

    public void Test()
    {
        this = new MyStruct(5);
    }
}

// Fixed code
struct MyStruct
{
    public int Value;

    public MyStruct(int value)
    {
        Value = value;
    }

    public void Test()
    {
        this = new MyStruct(5);
    }
}

抑制警告

如果只想抑制单个冲突,请将预处理器指令添加到源文件以禁用该规则,然后重新启用该规则。

#pragma warning disable IDE0064
// The code that's violating the rule is on this line.
#pragma warning restore IDE0064

若要对文件、文件夹或项目禁用该规则,请在配置文件中将其严重性设置为 none

[*.{cs,vb}]
dotnet_diagnostic.IDE0064.severity = none

若要禁用此整个规则类别,请在配置文件中将此类别的严重性设置为 none

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-CodeQuality.severity = none

有关详细信息,请参阅如何禁止显示代码分析警告

另请参阅