2020-12-23 14:59:06 +01:00
Invoking a method designed to return a string representation of an object which is already a string is a waste of keystrokes. Similarly, explicitly invoking ``ToString()`` when the compiler would do it implicitly is also needless code-bloat.
2020-06-30 12:47:33 +02:00
2020-12-23 14:59:06 +01:00
This rule raises an issue when ``ToString()`` is invoked:
2020-06-30 14:49:38 +02:00
2020-12-23 14:59:06 +01:00
* on a ``string``
* on a non-``string`` operand to concatenation
* on an argument to ``string.Format``
2020-06-30 12:47:33 +02:00
== Noncompliant Code Example
----
var s = "foo";
var t = "fee fie foe " + s.ToString(); // Noncompliant
var someObject = new object();
var u = "" + someObject.ToString(); // Noncompliant
var v = string.Format("{0}", someObject.ToString()); // Noncompliant
----
== Compliant Solution
----
var s = "foo";
var t = "fee fie foe " + s;
var someObject = new object();
var u = "" + someObject;
var v = string.Format("{0}", someObject);
----
== Exceptions
2020-12-23 14:59:06 +01:00
The rule does not report on value types, where leaving off the ``ToString()`` call would result in automatic boxing.
2020-06-30 14:49:38 +02:00
2020-06-30 12:47:33 +02:00
----
var v = string.Format("{0}", 1.ToString());
----