Stream.Write 方法

参考

定义

命名空间:: System.IO

程序集:: System.Runtime.dll

程序集:: netstandard.dll

程序集:: System.IO.dll

程序集:: mscorlib.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

Write(ReadOnlySpan<Byte>)	当在派生类中重写时，向当前流中写入字节序列，并将此流中的当前位置提升写入的字节数。
Write(Byte[], Int32, Int32)	当在派生类中重写时，向当前流中写入字节序列，并将此流中的当前位置提升写入的字节数。

Write(ReadOnlySpan<Byte>)

Source:: Stream.cs

Source:: Stream.cs

Source:: Stream.cs

当在派生类中重写时，向当前流中写入字节序列，并将此流中的当前位置提升写入的字节数。

public:
 virtual void Write(ReadOnlySpan<System::Byte> buffer);

public virtual void Write (ReadOnlySpan<byte> buffer);

abstract member Write : ReadOnlySpan<byte> -> unit
override this.Write : ReadOnlySpan<byte> -> unit

Public Overridable Sub Write (buffer As ReadOnlySpan(Of Byte))

参数

buffer: ReadOnlySpan<Byte>

内存的区域。此方法将此区域的内容复制到当前流。

注解

CanWrite使用属性确定当前实例是否支持写入。 WriteAsync使用方法以异步方式写入当前流。

如果写入操作成功，则流中的位置将按写入的字节数前进。如果发生异常，则流中的位置保持不变。

适用于

.NET 9 和其他版本

产品	版本
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Write(Byte[], Int32, Int32)

Source:: Stream.cs

Source:: Stream.cs

Source:: Stream.cs

当在派生类中重写时，向当前流中写入字节序列，并将此流中的当前位置提升写入的字节数。

public:
 abstract void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public abstract void Write (byte[] buffer, int offset, int count);

abstract member Write : byte[] * int * int -> unit

Public MustOverride Sub Write (buffer As Byte(), offset As Integer, count As Integer)

参数

buffer: Byte[]

字节数组。此方法将 count 个字节从 buffer 复制到当前流。

offset: Int32

buffer 中的从零开始的字节偏移量，从此处开始将字节复制到当前流。

count: Int32

要写入当前流的字节数。

例外

ArgumentException

offset 和 count 的总和大于缓冲区长度。

ArgumentNullException

buffer 为 null。

ArgumentOutOfRangeException

offset 或 count 为负数。

IOException

发生 I/O 错误，例如找不到指定文件。

NotSupportedException

流不支持写入。

ObjectDisposedException

在流关闭后调用 Write(Byte[], Int32, Int32)。

注解