Fred Tingaud 16f6c0aecf
Inline adoc when include has no additional value (#1940)
Inline adoc files when they are included exactly once.

Also fix language tags because this inlining gives us better information
on what language the code is written in.
2023-05-25 14:18:12 +02:00

73 lines
1.0 KiB
Plaintext

== Why is this an issue?
The NET Framework 2.0 introduced the generic interface ``++System.Collections.Generic.IEnumerable<T>++`` and it should be preferred over the older, non generic, interfaces.
This rule raises an issue when a public type implements ``++System.Collections.IEnumerable++``.
=== Noncompliant code example
[source,csharp]
----
using System;
using System.Collections;
public class MyData
{
public MyData()
{
}
}
public class MyList : CollectionBase // Noncompliant
{
public void Add(MyData data)
{
InnerList.Add(data);
}
// ...
}
----
=== Compliant solution
[source,csharp]
----
using System;
using System.Collections.ObjectModel;
public class MyData
{
public MyData()
{
}
}
public class MyList : Collection<MyData>
{
// Implementation...
}
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
=== Message
Refactor this collection to implement [IEnumerable<T>|ICollection<T>|IList<T>]
=== Highlighting
Class declaration
endif::env-github,rspecator-view[]