RandomAccess.WriteAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Överlagringar
| Name | Description |
|---|---|
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
Skriver en sekvens med byte från angivna buffertar till angiven fil vid given förskjutning. |
| WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken) |
Skriver en sekvens med byte från given buffert till given fil vid given förskjutning. |
WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
Skriver en sekvens med byte från angivna buffertar till angiven fil vid given förskjutning.
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 ValueTaskParametrar
- handle
- SafeFileHandle
Filhandtaget.
- buffers
- IReadOnlyList<ReadOnlyMemory<Byte>>
En lista över minnesbuffertar. Den här metoden kopierar innehållet i dessa buffertar till filen.
- fileOffset
- Int64
Filpositionen att skriva till. I .NET 11 och senare versioner ignoreras den här parametern för filer som inte stöder sökning, till exempel rör, socketar och teckenenheter. Värdet måste vara icke-negativt även när det ignoreras.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En uppgift som representerar den asynkrona slutförandet av skrivåtgärden.
Undantag
handle eller buffers är null.
handle är ogiltigt.
Filen är stängd.
I .NET 10 och tidigare versioner stöder filen inte sökning (till exempel ett rör eller en socket).
fileOffset är negativ.
handle inte öppnats för skrivning.
Ett I/O-fel uppstod.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
För filer som stöder sökning är filpositionen inte avancerad.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).
Gäller för
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
Skriver en sekvens med byte från given buffert till given fil vid given förskjutning.
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 ValueTaskParametrar
- handle
- SafeFileHandle
Filhandtaget.
- buffer
- ReadOnlyMemory<Byte>
En region med minne. Den här metoden kopierar innehållet i den här regionen till filen.
- fileOffset
- Int64
Filpositionen att skriva till. I .NET 11 och senare versioner ignoreras den här parametern för filer som inte stöder sökning, till exempel rör, socketar och teckenenheter. Värdet måste vara icke-negativt även när det ignoreras.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En uppgift som representerar den asynkrona slutförandet av skrivåtgärden.
Undantag
handle är null.
handle är ogiltigt.
Filen är stängd.
I .NET 10 och tidigare versioner stöder filen inte sökning (till exempel ett rör eller en socket).
fileOffset är negativ.
handle inte öppnats för skrivning.
Ett I/O-fel uppstod.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
För filer som stöder sökning är filpositionen inte avancerad.
