Compartilhar via


Adicionar valores a enumerações

As seguintes diretrizes discute apresentando um dividindo potencialmente alterar para usuários de suas bibliotecas. Se você adicionar valores para uma enumeração lançada anteriormente, o código de aplicativo existente pode não ser robusto o suficiente para lidar com os novos valores.

Considere a possibilidade de adicionar valores a enumerações, apesar de um risco pequeno de compatibilidade.

Essa diretriz é relevante quando se esperava ao envio de mais de uma versão da sua biblioteca. Para minimizar o código que quebra devido à adição de valores em uma enumeração existente, você pode implementar novos membros retornam o conjunto completo de valores e marcar os membros existentes (que retornam o conjunto original de valores) usando o ObsoleteAttribute atributo. Se alterações significativas não forem aceitáveis, você pode definir uma nova enumeração e os membros associados que funcionam com ele e marcar os membros existentes e a enumeração como obsoleto.

Portions Copyright 2005 Microsoft Corporation. Todos os direitos reservados.

Portions Copyright Addison-Wesley Corporation. Todos os direitos reservados.

Para obter mais informações sobre as diretrizes de design, consulte a "diretrizes de Design do Framework: Convenções, idiomas e padrões de reutilizável.Bibliotecas de rede" catálogo por Krzysztof Cwalina e Brad Abrams, publicado pela Addison-Wesley, 2005.

Consulte também

Conceitos

Design de enumeração

Enumerações de sinalizadores de criação

Outros recursos

Diretrizes de Design do tipo

Diretrizes de Design para desenvolvimento bibliotecas de classe