Propriedade de System.Exception.Data

Use o System.Collections.IDictionary objeto retornado pela Data propriedade para armazenar e recuperar informações suplementares relevantes para a exceção. As informações estão na forma de um número arbitrário de pares chave/valor definidos pelo usuário. O componente chave de cada par chave/valor é normalmente uma cadeia de caracteres de identificação, enquanto o componente de valor do par pode ser qualquer tipo de objeto.

Segurança do par chave/valor

Os pares chave/valor armazenados na coleção retornada pela propriedade Data não são seguros. Se seu aplicativo chama uma série aninhada de rotinas e cada rotina contém manipuladores de exceção, a pilha de chamadas resultante contém uma hierarquia desses manipuladores de exceção. Se uma rotina de nível inferior lançar uma exceção, qualquer manipulador de exceção de nível superior na hierarquia de pilha de chamadas poderá ler e/ou modificar os pares chave/valor armazenados na coleção por qualquer outro manipulador de exceções. Isso significa que você deve garantir que as informações nos pares chave/valor não são confidenciais e que seu aplicativo funcionará corretamente se as informações nos pares chave/valor estiverem corrompidas.

Principais conflitos

Um conflito de chave ocorre quando diferentes manipuladores de exceção especificam a mesma chave para acessar um par chave/valor. Tenha cuidado ao desenvolver seu aplicativo porque a consequência de um conflito de chave é que manipuladores de exceção de nível inferior podem se comunicar inadvertidamente com manipuladores de exceção de nível superior, e essa comunicação pode causar erros sutis de programa. No entanto, se você for cauteloso, você pode usar conflitos de chave para melhorar seu aplicativo.

Evite conflitos importantes

Evite conflitos de chaves adotando uma convenção de nomenclatura para gerar chaves exclusivas para pares chave/valor. Por exemplo, uma convenção de nomenclatura pode gerar uma chave que consiste no nome delimitado por período do seu aplicativo, no método que fornece informações suplementares para o par e em um identificador exclusivo.

Suponha que dois aplicativos, chamados Produtos e Fornecedores, cada um tenha um método chamado Vendas. O método Sales na aplicação Produtos fornece o número identificador (a unidade de manutenção de stock ou SKU) de um produto. O método Sales no aplicativo Fornecedores fornece o número de identificação, ou SID, de um fornecedor. Consequentemente, a convenção de nomenclatura para este exemplo produz as chaves, "Products.Sales.SKU" e "Suppliers.Sales.SID".

Tirar partido de conflitos-chave

Aproveitar conflitos-chave usando a presença de uma ou mais chaves especiais e pré-definidas para controlar o processamento. Suponhamos que, em um cenário, o manipulador de exceções de nível mais alto na hierarquia da pilha de chamadas captura todas as exceções lançadas por manipuladores de exceção de nível inferior. Se existir um par chave/valor com uma chave especial, o manipulador de exceções de alto nível formata os pares chave/valor restantes no objeto de IDictionary alguma forma não padrão, caso contrário, os pares chave/valor restantes são formatados de alguma maneira normal.

Agora suponha que, em outro cenário, o manipulador de exceção em cada nível da hierarquia da pilha de chamadas captura a exceção lançada pelo próximo manipulador de exceção de nível inferior. Além disso, cada manipulador de exceção sabe que a Data coleção retornada pela propriedade contém um conjunto de pares chave/valor que podem ser acessados com um conjunto pré-organizado de chaves.

Cada manipulador de exceção usa o conjunto prearranjado de chaves para atualizar o componente de valor do par chave/valor correspondente com informações exclusivas para esse manipulador de exceções. Após a conclusão do processo de atualização, o manipulador de exceções lança a exceção para o próximo manipulador de exceção de nível superior. Finalmente, o manipulador de exceção de nível mais alto acessa os pares chave/valor e exibe as informações de atualização consolidadas de todos os manipuladores de exceção de nível inferior.