Stream.DisposeAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Geeft asynchroon de onbeheerde resources vrij die worden gebruikt door de Stream.
public:
virtual System::Threading::Tasks::ValueTask DisposeAsync();public virtual System.Threading.Tasks.ValueTask DisposeAsync();abstract member DisposeAsync : unit -> System.Threading.Tasks.ValueTask
override this.DisposeAsync : unit -> System.Threading.Tasks.ValueTaskPublic Overridable Function DisposeAsync () As ValueTaskRetouren
Een taak die de asynchrone verwijderingsbewerking aangeeft.
Implementeringen
Opmerkingen
Met de DisposeAsync methode kunt u een resourceintensieve verwijderingsbewerking uitvoeren zonder de hoofdthread te blokkeren. Deze prestatieoverweging is met name belangrijk in een Windows 8.x Store-app of -desktop-app, waarbij een tijdrovende streambewerking de UI-thread kan blokkeren en uw app kan weergeven alsof deze niet werkt. De asynchrone methoden worden gebruikt in combinatie met de trefwoorden async en await in Visual Basic en C#.
Met deze methode wordt de stream verwijderd door wijzigingen in het backingarchief te schrijven en de stream te sluiten om resources vrij te geven.
Door aanroepen DisposeAsync kunnen de resources die door de Stream resources worden gebruikt, opnieuw worden toegewezen voor andere doeleinden. Zie Onbeheerde resources opschonen voor meer informatie.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Dispose()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.