RandomAccess.Write 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64)	將指定緩衝區中的位元組序列寫入指定位移的指定檔案。
Write(SafeFileHandle, ReadOnlySpan<Byte>, Int64)	將指定緩衝區中的位元組序列寫入指定位移的指定檔案。

Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64)

來源:

RandomAccess.cs

將指定緩衝區中的位元組序列寫入指定位移的指定檔案。

public:
 static void Write(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::Collections::Generic::IReadOnlyList<ReadOnlyMemory<System::Byte>> ^ buffers, long fileOffset);

public static void Write (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> buffers, long fileOffset);

static member Write : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> * int64 -> unit

Public Shared Sub Write (handle As SafeFileHandle, buffers As IReadOnlyList(Of ReadOnlyMemory(Of Byte)), fileOffset As Long)

參數

handle

SafeFileHandle

檔句柄。

buffers

IReadOnlyList<ReadOnlyMemory<Byte>>

記憶體緩衝區的清單。 這個方法會將這些緩衝區的內容複製到檔案。

fileOffset

Int64

要寫入的檔案位置。

例外狀況

ArgumentNullException

handle 或 buffers 為 null。

ArgumentException

handle 無效。

ObjectDisposedException

檔案已關閉。

NotSupportedException

檔案不支援搜尋 (管道或套接字) 。

ArgumentOutOfRangeException

fileOffset 為負。

UnauthorizedAccessException

handle 未開啟以供寫入。

IOException

發生 I/O 錯誤。

備註

檔案的位置不是進階的。

Write(SafeFileHandle, ReadOnlySpan<Byte>, Int64)

來源:

RandomAccess.cs

將指定緩衝區中的位元組序列寫入指定位移的指定檔案。

public:
 static void Write(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, ReadOnlySpan<System::Byte> buffer, long fileOffset);

public static void Write (Microsoft.Win32.SafeHandles.SafeFileHandle handle, ReadOnlySpan<byte> buffer, long fileOffset);

static member Write : Microsoft.Win32.SafeHandles.SafeFileHandle * ReadOnlySpan<byte> * int64 -> unit

Public Shared Sub Write (handle As SafeFileHandle, buffer As ReadOnlySpan(Of Byte), fileOffset As Long)

參數

handle

SafeFileHandle

檔句柄。

buffer

ReadOnlySpan<Byte>

記憶體區域。 這個方法會將這個區域的內容複製到檔案。

fileOffset

Int64

要寫入的檔案位置。

例外狀況

ArgumentNullException

handle 為 null。

ArgumentException

handle 無效。

ObjectDisposedException

檔案已關閉。

NotSupportedException

檔案不支援搜尋 (管道或套接字) 。

ArgumentOutOfRangeException

fileOffset 為負。

UnauthorizedAccessException

handle 未開啟以供寫入。

IOException

發生 I/O 錯誤。

備註

檔案的位置不是進階的。