RandomAccess.WriteAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
Menulis urutan byte dari buffer yang diberikan ke file yang diberikan pada offset yang diberikan. |
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken) |
Menulis urutan byte dari buffer yang diberikan ke file yang diberikan pada offset yang diberikan. |
WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)
- Sumber:
- RandomAccess.cs
- Sumber:
- RandomAccess.cs
- Sumber:
- RandomAccess.cs
Menulis urutan byte dari buffer yang diberikan ke file yang diberikan pada offset yang diberikan.
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.ValueTask
Public Shared Function WriteAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of ReadOnlyMemory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask
Parameter
- handle
- SafeFileHandle
Handel file.
- buffers
- IReadOnlyList<ReadOnlyMemory<Byte>>
Daftar buffer memori. Metode ini menyalin isi buffer ini ke file.
- fileOffset
- Int64
Posisi file untuk ditulis.
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.
Mengembalikan
Tugas yang mewakili penyelesaian asinkron operasi tulis.
Pengecualian
handle
atau buffers
adalah null
.
handle
tidak valid.
File ditutup.
File tidak mendukung pencarian (pipa atau soket).
fileOffset
negatif.
handle
tidak dibuka untuk menulis.
Terjadi kesalahan I/O.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Posisi file tidak tingkat lanjut.
Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).
Berlaku untuk
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)
- Sumber:
- RandomAccess.cs
- Sumber:
- RandomAccess.cs
- Sumber:
- RandomAccess.cs
Menulis urutan byte dari buffer yang diberikan ke file yang diberikan pada offset yang diberikan.
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.ValueTask
Public Shared Function WriteAsync (handle As SafeFileHandle, buffer As ReadOnlyMemory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask
Parameter
- handle
- SafeFileHandle
Handel file.
- buffer
- ReadOnlyMemory<Byte>
Wilayah memori. Metode ini menyalin isi wilayah ini ke file.
- fileOffset
- Int64
Posisi file untuk ditulis.
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.
Mengembalikan
Tugas yang mewakili penyelesaian asinkron operasi tulis.
Pengecualian
handle
adalah null
.
handle
tidak valid.
File ditutup.
File tidak mendukung pencarian (pipa atau soket).
fileOffset
negatif.
handle
tidak dibuka untuk menulis.
Terjadi kesalahan I/O.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Posisi file tidak tingkat lanjut.
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk