Stream.Write 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

重载

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

Write(ReadOnlySpan<Byte>)

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使用 方法以异步方式写入当前流。

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

Write(Byte[], Int32, Int32)

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)。

注解

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

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

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件