Diretrizes de design da estrutura

Esta seção fornece diretrizes para projetar bibliotecas que estendem e interagem com o .NET. O objetivo é ajudar os designers de bibliotecas a garantir a consistência da API e a facilidade de uso, fornecendo um modelo de programação unificado que seja independente da linguagem de programação usada para o desenvolvimento. Recomendamos que você siga estas diretrizes de design ao desenvolver classes e componentes que estendem o .NET. O design inconsistente da biblioteca afeta negativamente a produtividade do desenvolvedor e desencoraja a adoção.

As diretrizes são organizadas como recomendações simples prefixadas com os termos Do, Consider, Avoid, e Do not. Estas diretrizes destinam-se a ajudar os designers de bibliotecas de classes a entender as compensações entre diferentes soluções. Pode haver situações em que um bom design de biblioteca exija que você viole essas diretrizes de design. Estes casos devem ser raros e é importante que tenha uma razão clara e convincente para a sua decisão.

Essas diretrizes são extraídas do livro Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition, de Krzysztof Cwalina e Brad Abrams, publicado em 2008. Desde então, o livro foi totalmente revisto na terceira edição. Algumas das informações contidas nestas orientações podem estar desatualizadas.

Nesta secção

Diretrizes de nomenclatura
Fornece diretrizes para nomear assemblies, namespaces, tipos e membros em bibliotecas de classes.

Diretrizes de Design Tipográfico
Fornece diretrizes para o uso de classes estáticas e abstratas, interfaces, enumerações, estruturas e outros tipos.

Diretrizes de design de componentes
Fornece diretrizes para projetar e usar propriedades, métodos, construtores, campos, eventos, operadores e parâmetros.

Projetando para extensibilidade
Discute mecanismos de extensibilidade, como subclassificação, uso de eventos, membros virtuais e retornos de chamada, e explica como escolher os mecanismos que melhor atendem aos requisitos da sua estrutura.

Diretrizes de design para exceções
Descreve as diretrizes de design para projetar, lançar e capturar exceções.

Diretrizes de uso
Descreve diretrizes para o uso de tipos comuns, como matrizes, atributos e coleções, suporte à serialização e sobrecarga de operadores de igualdade.

Padrões de design comuns
Fornece diretrizes para escolher e implementar propriedades de dependência e o padrão de descarte.

© Trechos 2005, 2009 Microsoft Corporation. Todos os direitos reservados.

Reimpresso com permissão da Pearson Education, Inc., a partir de Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition por Krzysztof Cwalina e Brad Abrams, publicado em 22 de outubro de 2008 pela Addison-Wesley Professional como parte da Microsoft Windows Development Series.