语言

RandomAccess.Write 方法

定义

重载

名称 说明
Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64)

将给定缓冲区中的字节序列写入给定偏移量处的给定文件。

Write(SafeFileHandle, ReadOnlySpan<Byte>, Int64)

将给定缓冲区中的字节序列写入给定偏移量处的给定文件。

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

Source:
RandomAccess.cs
Source:
RandomAccess.cs
Source:
RandomAccess.cs
Source:
RandomAccess.cs
Source:
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

要写入的文件位置。 在 .NET 11 及更高版本中,不支持查找的文件(如管道、套接字和字符设备)将忽略此参数。 即使忽略该值,该值也必须为非负值。

例外

handle 或 buffers 为 null.

handle 无效。

文件已关闭。

在 .NET 10 及更早版本中,该文件不支持查找(例如管道或套接字)。

fileOffset 为负数。

handle 没有打开写作。

出现 I/O 错误。

注解

对于支持查找的文件,文件位置并不先进。

适用于

Write(SafeFileHandle, ReadOnlySpan<Byte>, Int64)

Source:
RandomAccess.cs
Source:
RandomAccess.cs
Source:
RandomAccess.cs
Source:
RandomAccess.cs
Source:
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

要写入的文件位置。 在 .NET 11 及更高版本中,不支持查找的文件(如管道、套接字和字符设备)将忽略此参数。 即使忽略该值,该值也必须为非负值。

例外

handle 是 null。

handle 无效。

文件已关闭。

在 .NET 10 及更早版本中,该文件不支持查找(例如管道或套接字)。

fileOffset 为负数。

handle 没有打开写作。

出现 I/O 错误。

注解

对于支持查找的文件,文件位置并不先进。

适用于