CA1059: члены не должны предоставлять определенные устойчивые типы
Товар | Значение |
---|---|
Идентификатор правила | CA1059 |
Категория | Microsoft.Design |
Критическое изменение | Критическое |
Причина
Внешний видимый элемент является определенным конкретным типом или предоставляет определенные типы через один из его параметров или возвращаемого значения. В настоящее время это правило сообщает о воздействии следующих конкретных типов:
- Тип, производный от System.Xml.XmlNode.
Примечание.
Это правило устарело. Дополнительные сведения см. в разделе "Устаревшие правила".
Описание правила
Устойчивый тип – это тип, который имеет полную реализацию и экземпляр которого можно создать. Чтобы разрешить широкое использование элемента, замените конкретный тип предлагаемым интерфейсом. Это позволяет члену принимать любой тип, реализующий интерфейс или используемый, где ожидается тип, реализующий интерфейс.
В следующей таблице перечислены целевые типы конкретных типов и их предлагаемые замены.
Конкретный тип | Замена |
---|---|
XPathDocument | System.Xml.XPath.IXPathNavigable. Использование интерфейса отделяет член от определенной реализации источника данных XML. |
Устранение нарушений
Чтобы устранить нарушение этого правила, измените конкретный тип на предлагаемый интерфейс.
Когда лучше отключить предупреждения
Это безопасно для подавления сообщения из этого правила, если требуется определенная функциональность, предоставляемая конкретным типом.
Связанные правила
CA1011: попробуйте передать базовые типы в качестве параметров
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по