Compartilhar via


Diretrizes de design da estrutura

Esta seção fornece diretrizes para criar bibliotecas que estendem e interagem com o .NET. O objetivo é ajudar os designers de biblioteca a garantir a consistência da API e a facilidade de uso fornecendo um modelo de programação unificado independente da linguagem de programação usada para desenvolvimento. Recomendamos que você siga essas diretrizes de design ao desenvolver classes e componentes que estendam 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, Considere AvoidDo not. Essas diretrizes destinam-se a ajudar os designers da biblioteca de classes a entender as compensações entre soluções diferentes. Pode haver situações em que um bom design de biblioteca exige que você viole essas diretrizes de design. Esses casos devem ser raros, e é importante que você tenha uma razão clara e convincente para sua decisão.

Essas diretrizes são extraídas do livro Diretrizes de Design da Estrutura: Convenções, Idiomas e Padrões para Bibliotecas .NET Reutilizáveis, 2ª Edição, de Krzysztof Cwalina e Brad Abrams, publicado em 2008. Desde então, o livro foi totalmente revisado na terceira edição. Algumas das informações nessas diretrizes podem estar desatualizadas.

Nesta seção

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

Diretrizes de Design de Tipografia
Fornece diretrizes para usar 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 subclasse, uso de eventos, membros virtuais e retornos de chamada, e explica como escolher os mecanismos que melhor atendem aos requisitos da estrutura.

Diretrizes de design para exceções
Descreve as diretrizes de design para criar, gerar e capturar exceções.

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

Padrões de design comuns
Fornece diretrizes para a escolha e implementação de propriedades de dependência e do padrão de descarte.

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

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