This documentation is archived and is not being maintained.

CA1058: Types should not extend certain base types







Breaking Change


For .NET Framework version 1, it was recommended to derive new exceptions from ApplicationException. The recommendation has changed and new exceptions should derive from System.Exception or one of its subclasses in the System namespace.

Do not create a subclass of XmlDocument if you want to create an XML view of an underlying object model or data source.

Use and/or extend generic collections whenever possible. Do not extend non-generic collections in your code, unless you shipped it previously.

Examples of Incorrect Usage

public class MyCollection : CollectionBase
public class MyReadOnlyCollection : ReadOnlyCollectionBase

Examples of Correct Usage

public class MyCollection : Collection<T>
public class MyReadOnlyCollection : ReadOnlyCollection<T>

To fix a violation of this rule, derive the type from a different base type or a generic collection.

Do not suppress a warning from this rule for violations about ApplicationException. It is safe to suppress a warning from this rule for violations about XmlDocument. It is safe to suppress a warning about a non-generic collection if the code was released previously.