LazyThreadSafetyMode Enum

Het Lazy<T> exemplaar is niet threadveilig. Als het exemplaar wordt geopend vanuit meerdere threads, is het gedrag ervan niet gedefinieerd. Gebruik deze modus alleen als hoge prestaties cruciaal zijn en het Lazy<T> exemplaar wordt gegarandeerd nooit geïnitialiseerd vanuit meer dan één thread. Als u een Lazy<T> constructor gebruikt waarmee een initialisatiemethode (valueFactory parameter) wordt opgegeven en als die initialisatiemethode een uitzondering genereert (of een uitzondering niet kan verwerken) wanneer u de eigenschap voor het Value eerst aanroept, wordt de uitzondering in de cache opgeslagen en opnieuw gegenereerd bij volgende aanroepen naar de Value eigenschap. Als u een Lazy<T> constructor gebruikt die geen initialisatiemethode opgeeft, worden uitzonderingen die door de parameterloze constructor T worden gegenereerd, niet in de cache opgeslagen. In dat geval kan een volgende aanroep van de Value eigenschap het Lazy<T> exemplaar initialiseren. Als de initialisatiemethode recursief toegang heeft tot de Value eigenschap van het Lazy<T> exemplaar, wordt er een InvalidOperationException gegenereerd.

Wanneer meerdere threads tegelijkertijd een Lazy<T> exemplaar proberen te initialiseren, mogen alle threads de initialisatiemethode uitvoeren (of de constructor zonder parameters, als er geen initialisatiemethode is). Met de eerste thread voor het voltooien van de initialisatie wordt de waarde van het Lazy<T> exemplaar ingesteld. Dit wordt genoemd Publication in de veldnamen. Deze waarde wordt geretourneerd naar andere threads die tegelijkertijd de initialisatiemethode hebben uitgevoerd, tenzij de initialisatiemethode uitzonderingen op deze threads genereert. Alle exemplaren die T zijn gemaakt door de concurrerende threads, worden verwijderd. In feite is de publicatie van de geïnitialiseerde waarde thread-veilig in de zin dat slechts één van de geïnitialiseerde waarden kan worden gepubliceerd en gebruikt door alle threads. Als de initialisatiemethode een uitzondering genereert voor een thread, wordt de uitzondering buiten de Value eigenschap van die thread doorgegeven. De uitzondering wordt niet in de cache opgeslagen. De waarde van de IsValueCreated eigenschap blijft falsebehouden en de volgende aanroepen naar de Value eigenschap, ofwel door de thread waarin de uitzondering is opgetreden of door andere threads, zorgen ervoor dat de initialisatiemethode opnieuw wordt uitgevoerd. Als de initialisatiemethode recursief toegang heeft tot de Value eigenschap van het Lazy<T> exemplaar, wordt er geen uitzondering gegenereerd.

Vergrendelingen worden gebruikt om ervoor te zorgen dat slechts één thread een Lazy<T> exemplaar op een threadveilige manier kan initialiseren. In feite wordt de initialisatiemethode uitgevoerd op een threadveilige manier (aangeduid als Execution in de veldnaam). Publication van de geïnitialiseerde waarde is ook thread-veilig in de zin dat slechts één waarde kan worden gepubliceerd en gebruikt door alle threads. Als de initialisatiemethode (of de parameterloze constructor, als er geen initialisatiemethode is) intern vergrendelingen gebruikt, kunnen impasses optreden. Als u een Lazy<T> constructor gebruikt waarmee een initialisatiemethode (valueFactory parameter) wordt opgegeven en als die initialisatiemethode een uitzondering genereert (of een uitzondering niet kan verwerken) wanneer u de eigenschap voor het Value eerst aanroept, wordt de uitzondering in de cache opgeslagen en opnieuw gegenereerd bij volgende aanroepen naar de Value eigenschap. Als u een Lazy<T> constructor gebruikt die geen initialisatiemethode opgeeft, worden uitzonderingen die door de parameterloze constructor T worden gegenereerd, niet in de cache opgeslagen. In dat geval kan een volgende aanroep van de Value eigenschap het Lazy<T> exemplaar initialiseren. Als de initialisatiemethode recursief toegang heeft tot de Value eigenschap van het Lazy<T> exemplaar, wordt er een InvalidOperationException gegenereerd.