RandomAccess.WriteAsync 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.
Overloads
| Naam | Description |
|---|---|
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
Hiermee schrijft u een reeks bytes van opgegeven buffers naar het opgegeven bestand op een bepaalde offset. |
| WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken) |
Hiermee schrijft u een reeks bytes van de opgegeven buffer naar het opgegeven bestand op een bepaalde offset. |
WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
Hiermee schrijft u een reeks bytes van opgegeven buffers naar het opgegeven bestand op een bepaalde offset.
public static System.Threading.Tasks.ValueTask WriteAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);static member WriteAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Shared Function WriteAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of ReadOnlyMemory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParameters
- handle
- SafeFileHandle
De bestandsgreep.
- buffers
- IReadOnlyList<ReadOnlyMemory<Byte>>
Een lijst met geheugenbuffers. Met deze methode wordt de inhoud van deze buffers naar het bestand gekopieerd.
- fileOffset
- Int64
De bestandspositie waar naar moet worden geschreven. In .NET 11 en latere versies wordt deze parameter genegeerd voor bestanden die geen ondersteuning bieden voor zoeken, zoals pijpen, sockets en tekenapparaten. De waarde moet niet-negatief zijn, zelfs als deze wordt genegeerd.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Een taak die de asynchrone voltooiing van de schrijfbewerking aangeeft.
Uitzonderingen
handle of buffers is null.
handle is ongeldig.
Het bestand is gesloten.
In .NET 10 en eerdere versies biedt het bestand geen ondersteuning voor zoeken (bijvoorbeeld een pijp of socket).
fileOffset is negatief.
handle is niet geopend voor schrijven.
Er is een I/O-fout opgetreden.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Voor bestanden die ondersteuning bieden voor zoeken, is de bestandspositie niet geavanceerd.
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 Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
Hiermee schrijft u een reeks bytes van de opgegeven buffer naar het opgegeven bestand op een bepaalde offset.
public static System.Threading.Tasks.ValueTask WriteAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, ReadOnlyMemory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);static member WriteAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * ReadOnlyMemory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Shared Function WriteAsync (handle As SafeFileHandle, buffer As ReadOnlyMemory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParameters
- handle
- SafeFileHandle
De bestandsgreep.
- buffer
- ReadOnlyMemory<Byte>
Een geheugengebied. Met deze methode wordt de inhoud van deze regio gekopieerd naar het bestand.
- fileOffset
- Int64
De bestandspositie waar naar moet worden geschreven. In .NET 11 en latere versies wordt deze parameter genegeerd voor bestanden die geen ondersteuning bieden voor zoeken, zoals pijpen, sockets en tekenapparaten. De waarde moet niet-negatief zijn, zelfs als deze wordt genegeerd.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Een taak die de asynchrone voltooiing van de schrijfbewerking aangeeft.
Uitzonderingen
handle is null.
handle is ongeldig.
Het bestand is gesloten.
In .NET 10 en eerdere versies biedt het bestand geen ondersteuning voor zoeken (bijvoorbeeld een pijp of socket).
fileOffset is negatief.
handle is niet geopend voor schrijven.
Er is een I/O-fout opgetreden.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Voor bestanden die ondersteuning bieden voor zoeken, is de bestandspositie niet geavanceerd.
