LazyThreadSafetyMode Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica como uma instância de Lazy<T> sincroniza o acesso entre vários threads.
public enum class LazyThreadSafetyModepublic enum LazyThreadSafetyModetype LazyThreadSafetyMode = Public Enum LazyThreadSafetyMode- Herança
Campos
| Nome | Valor | Description |
|---|---|---|
| None | 0 | A Lazy<T> instância não é thread-safe; se a instância for acessada de vários threads, seu comportamento será indefinido. Use esse modo somente quando o alto desempenho for crucial e a Lazy<T> instância tiver a garantia de nunca ser inicializada de mais de um thread. Se você usar um Lazy<T> construtor que especifica um método de inicialização ( |
| PublicationOnly | 1 | Quando vários threads tentam inicializar uma Lazy<T> instância simultaneamente, todos os threads têm permissão para executar o método de inicialização (ou o construtor sem parâmetros, se não houver nenhum método de inicialização). O primeiro thread para concluir a inicialização define o valor da Lazy<T> instância. Isso é conhecido como |
| ExecutionAndPublication | 2 | Os bloqueios são usados para garantir que apenas um único thread possa inicializar uma Lazy<T> instância de maneira thread-safe. Efetivamente, o método de inicialização é executado de maneira thread-safe (conhecida como |
Comentários
Use essa enumeração para especificar o mode parâmetro de Lazy<T> construtores. Os efeitos de todos os construtores na sincronização de thread podem ser descritos em termos dessa enumeração, independentemente de terem mode ou não parâmetros.
Uma Lazy<T> instância é inicializada por um método de inicialização especificado pelo usuário ou pelo construtor sem parâmetros para T. O método de inicialização é especificado pelo valueFactory parâmetro de um Lazy<T> construtor. O método retorna uma instância de T, que é o tipo que é preguiçosamente instanciado pela instância de Lazy<T>. Se um construtor não tiver um valueFactory parâmetro, o construtor sem parâmetros será T usado para inicializar a Lazy<T> instância. Em ambos os casos, a inicialização ocorre na primeira vez que você chama a Lazy<T>.Value propriedade.
Além de especificar a segurança de thread de uma Lazy<T> instância, essa enumeração afeta o cache de exceção. Quando as exceções são armazenadas em cache para uma Lazy<T> instância, você tem apenas uma chance de inicializar a instância. Se uma exceção for gerada na primeira vez que você chamar a Lazy<T>.Value propriedade, essa exceção será armazenada em cache e será relançada em todas as chamadas subsequentes à Lazy<T>.Value propriedade. A vantagem das exceções de cache é que todos os dois threads sempre obtêm o mesmo resultado, mesmo quando ocorrem erros.
Quando você especifica o modo PublicationOnly, as exceções nunca são armazenadas em cache. Quando você especifica None ou ExecutionAndPublication, o cache depende de você especificar um método de inicialização ou permitir que o construtor T sem parâmetros seja usado. Especificar um método de inicialização permite o cache de exceções para esses dois modos. O método de inicialização pode ser muito simples. Por exemplo, ele pode chamar o construtor sem parâmetros para T: new Lazy<Contents>(() => new Contents(), mode) em C# ou New Lazy(Of Contents)(Function() New Contents()) em Visual Basic. Se você usar um construtor que não especifique um método de inicialização, as exceções geradas pelo construtor T sem parâmetros não serão armazenadas em cache. A tabela a seguir resume o comportamento de cache de exceção.
| Modo | Usando o método de inicialização | Usando o construtor sem parâmetros para T |
|---|---|---|
| Nenhum | Cache | Não armazenado em cache |
| PublicationOnly | Não armazenado em cache | Não armazenado em cache |
| Executionandpublication | Cache | Não armazenado em cache |
