rspec/rules/S3236/rule.adoc

42 lines
962 B
Plaintext
Raw Normal View History

2020-12-23 14:59:06 +01:00
Caller information attributes: ``CallerFilePathAttribute`` and ``CallerLineNumberAttribute`` provide a way to get information about the caller of a method through optional parameters. But the arguments for these optional parameters are only generated if they are not explicitly defined in the call. Thus, specifying the argument values defeats the purpose of the attributes.
2020-06-30 12:48:39 +02:00
== Noncompliant Code Example
----
void TraceMessage(string message,
[CallerFilePath] string filePath = null,
[CallerLineNumber] int lineNumber = 0)
{
/* ... */
}
void MyMethod()
{
TraceMessage("my message", "A.B.C.Foo.cs", 42); // Noncompliant
}
----
== Compliant Solution
----
void TraceMessage(string message,
[CallerFilePath] string filePath = "",
[CallerLineNumber] int lineNumber = 0)
{
/* ... */
}
void MyMethod()
{
TraceMessage("my message");
}
----
== Exceptions
2020-12-23 14:59:06 +01:00
``CallerMemberName`` is not checked to avoid False-Positives with WPF/UWP applications.
2020-06-30 12:48:39 +02:00