Do not use Optional on ref or out. parameters

Docs > Code Analysis > Static Analysis Rules > Do not use Optional on ref or out. parameters

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

Metadata

ID: csharp-best-practices/optional-ref-out

Language: C#

Severity: Info

Category: Best Practices

Description

The modifier Optional should not be used on ref or out parameters because it’s semantically incorrect:

an out parameter is used as a value to return from the function and, therefore, is not optional
a ref parameter is passed back to the caller

Non-Compliant Code Examples

class MyClass {

    public static void routine([Optional] out i)
    {
    }
}

class MyClass {
    public static void routine([Optional] ref int i)
    {
    }

}

How to use this rule

1
2
rulesets:
  - csharp-best-practices     # Rules to enforce C# best practices.

Create a static-analysis.datadog.yml with the content above at the root of your repository
Use our free IDE Plugins or add Code Analysis scans to your CI pipelines
Get feedback on your code

For more information, please read the Code Analysis documentation

VS Code Extension

Identify code vulnerabilities directly in your
VS Code editor

JetBrains Plugin

Identify code vulnerabilities directly in
JetBrains products