Рекомендации по разработке платформыFramework Design Guidelines

В этом разделе приводятся рекомендации по проектированию библиотек, которые расширяют и взаимодействуют с .NET Framework.This section provides guidelines for designing libraries that extend and interact with the .NET Framework. Цель состоит в том, чтобы помочь дизайнерам библиотек обеспечить согласованность и простоту использования API, предоставляя унифицированную модель программирования, которая не зависит от языка программирования, используемого для разработки.The goal is to help library designers ensure API consistency and ease of use by providing a unified programming model that is independent of the programming language used for development. При разработке классов и компонентов, расширяющих .NET Framework, рекомендуется следовать этим рекомендациям по проектированию.We recommend that you follow these design guidelines when developing classes and components that extend the .NET Framework. Непоследовательная структура библиотеки негативно влияет на производительность разработки и не дорекомендует внедрения.Inconsistent library design adversely affects developer productivity and discourages adoption.

Рекомендации организованы в виде простых рекомендаций с префиксами Do, Consider, Avoidи Do not.The guidelines are organized as simple recommendations prefixed with the terms Do, Consider, Avoid, and Do not. Эти рекомендации предназначены для того, чтобы помочь дизайнерам библиотек классов понять компромиссы между различными решениями.These guidelines are intended to help class library designers understand the trade-offs between different solutions. Возможны ситуации, когда хорошая структура библиотеки требует соблюдения этих рекомендаций по проектированию.There might be situations where good library design requires that you violate these design guidelines. Такие случаи должны быть редкими, и важно иметь четкие и интересные причины для принятия решения.Such cases should be rare, and it is important that you have a clear and compelling reason for your decision.

Эти рекомендации взяты из руководства по проектированию для платформы книги: соглашения, идиомы и закономерности для многократно используемых библиотек .NET, 2-го выпуска, Крзисзтоф Квалина и Михаил Abrams).These guidelines are excerpted from the book Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition, by Krzysztof Cwalina and Brad Abrams.

В этом разделеIn This Section

Правила именованияNaming Guidelines
Содержит рекомендации по именованию сборок, пространств имен, типов и членов в библиотеках классов.Provides guidelines for naming assemblies, namespaces, types, and members in class libraries.

Рекомендации по разработке типовType Design Guidelines
Содержит рекомендации по использованию статических и абстрактных классов, интерфейсов, перечислений, структур и других типов.Provides guidelines for using static and abstract classes, interfaces, enumerations, structures, and other types.

Правила разработки членовMember Design Guidelines
Содержит рекомендации по проектированию и использованию свойств, методов, конструкторов, полей, событий, операторов и параметров.Provides guidelines for designing and using properties, methods, constructors, fields, events, operators, and parameters.

Разработка с обеспечением расширяемостиDesigning for Extensibility
Обсуждаются механизмы расширения, такие как создание подклассов, использование событий, виртуальные члены и обратные вызовы, а также объясняется, как выбрать механизмы, которые наилучшим образом соответствуют требованиям вашей платформы.Discusses extensibility mechanisms such as subclassing, using events, virtual members, and callbacks, and explains how to choose the mechanisms that best meet your framework's requirements.

Правила разработки исключенийDesign Guidelines for Exceptions
Описывает рекомендации по проектированию, созданию, генерации и перехвату исключений.Describes design guidelines for designing, throwing, and catching exceptions.

Правила использованияUsage Guidelines
Описывает рекомендации по использованию общих типов, таких как массивы, атрибуты и коллекции, поддержка сериализации и перегрузка операторов равенства.Describes guidelines for using common types such as arrays, attributes, and collections, supporting serialization, and overloading equality operators.

Обычные шаблоны разработкиCommon Design Patterns
Содержит рекомендации по выбору и реализации свойств зависимостей.Provides guidelines for choosing and implementing dependency properties.

Части © 2005, 2009 Корпорация Майкрософт. Все права защищены.Portions © 2005, 2009 Microsoft Corporation. All rights reserved.

Перепечатано с разрешения Pearson Education, Inc. из книги Инфраструктура программных проектов. Соглашения, идиомы и шаблоны для многократно используемых библиотек .NET (2-е издание), авторы: Кржиштоф Цвалина (Krzysztof Cwalina) и Брэд Абрамс (Brad Abrams). Книга опубликована 22 октября 2008 г. издательством Addison-Wesley Professional в рамках серии, посвященной разработке для Microsoft Windows.Reprinted by permission of Pearson Education, Inc. from Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition by Krzysztof Cwalina and Brad Abrams, published Oct 22, 2008 by Addison-Wesley Professional as part of the Microsoft Windows Development Series.

См. также:See also