diff --git a/docs/fundamentals/code-analysis/style-rules/ide0290.md b/docs/fundamentals/code-analysis/style-rules/ide0290.md index 2ac705366d18d..ffde613497f3e 100644 --- a/docs/fundamentals/code-analysis/style-rules/ide0290.md +++ b/docs/fundamentals/code-analysis/style-rules/ide0290.md @@ -24,6 +24,8 @@ dev_langs: This rule flags classes that can use a [primary constructor](../../../csharp/programming-guide/classes-and-structs/instance-constructors.md#primary-constructors) instead of a separate constructor definition. You define a primary constructor by placing any constructor parameters in parentheses following the type name. A primary constructor indicates that these parameters are necessary for any instance of the type. +When you create a class or struct with multiple constructors, you gain flexibility, but you also add verbose syntax. You must cleanly separate the constructor input from the class state. With primary constructors, you can put one constructor's parameters in scope for the whole class or struct. You can use these parameters for initialization or directly as object state. However, if you add other constructors, they must call through the primary constructor. + ## Options Options specify the behavior that you want the rule to enforce. For information about configuring options, see [Option format](language-rules.md#option-format).