语言

FileChannel.Write 方法

定义

重载

名称 说明
Write(ByteBuffer[])

从给定缓冲区将字节序列写入此通道。

Write(ByteBuffer[], Int32, Int32)

从给定缓冲区的子序列将字节序列写入此通道。

Write(ByteBuffer)

从给定缓冲区将字节序列写入此通道。

Write(ByteBuffer, Int64)

从给定的文件位置开始,从给定的缓冲区写入此通道的字节序列。

Write(ByteBuffer[])

从给定缓冲区将字节序列写入此通道。

[Android.Runtime.Register("write", "([Ljava/nio/ByteBuffer;)J", "")]
public long Write(Java.Nio.ByteBuffer[]? srcs);
[<Android.Runtime.Register("write", "([Ljava/nio/ByteBuffer;)J", "")>]
abstract member Write : Java.Nio.ByteBuffer[] -> int64
override this.Write : Java.Nio.ByteBuffer[] -> int64

参数

srcs
ByteBuffer[]

要从中检索字节的缓冲区

返回

写入的字节数,可能为零

实现

特性

例外

如果此通道在此写入操作期间由另一个线程关闭,

如果另一个线程在此操作正在进行时中断调用线程, 已设置调用线程的中断状态,并且通道已关闭。

如果此通道已关闭,则为 。

如果发生另一个 I/O 错误,则为详细信息位于消息中。

如果未打开此通道进行写入。

注解

从给定缓冲区将字节序列写入此通道。

字节从此通道的当前文件位置开始写入,除非通道处于追加模式,在这种情况下,位置首先会提前到文件末尾。 如有必要,文件将增长以适应写入的字节数,然后使用实际写入的字节数更新文件位置。 否则,此方法的行为与接口中指定的 GatheringByteChannel 完全相同。

适用于 . 的 java.nio.channels.FileChannel.write(java.nio.ByteBuffer[])Java 文档

Java参考java.nio.channels.FileChannel.write。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

Write(ByteBuffer[], Int32, Int32)

从给定缓冲区的子序列将字节序列写入此通道。

[Android.Runtime.Register("write", "([Ljava/nio/ByteBuffer;II)J", "GetWrite_arrayLjava_nio_ByteBuffer_IIHandler")]
public abstract long Write(Java.Nio.ByteBuffer[]? srcs, int offset, int length);
[<Android.Runtime.Register("write", "([Ljava/nio/ByteBuffer;II)J", "GetWrite_arrayLjava_nio_ByteBuffer_IIHandler")>]
abstract member Write : Java.Nio.ByteBuffer[] * int * int -> int64

参数

srcs
ByteBuffer[]

要从中检索字节的缓冲区

offset
Int32

要从中 buffers 获取字节的第一个缓冲区的索引。

length
Int32

要从中获取字节的缓冲区数。

返回

写入的字节数,可能为零

实现

特性

例外

如果此通道在此写入操作期间由另一个线程关闭,

如果另一个线程在此操作正在进行时中断调用线程, 已设置调用线程的中断状态,并且通道已关闭。

如果此通道已关闭,则为 。

如果offset 或length 大于其大小offset + length,则buffers为

如果发生另一个 I/O 错误,则为详细信息位于消息中。

如果未打开此通道进行写入。

注解

从给定缓冲区的子序列将字节序列写入此通道。

字节从此通道的当前文件位置开始写入,除非通道处于追加模式,在这种情况下,位置首先会提前到文件末尾。 如有必要,文件将增长以适应写入的字节数,然后使用实际写入的字节数更新文件位置。 否则,此方法的行为与接口中指定的 GatheringByteChannel 完全相同。

适用于 . 的 java.nio.channels.FileChannel.write(java.nio.ByteBuffer[], int, int)Java 文档

Java参考java.nio.channels.FileChannel.write。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

Write(ByteBuffer)

从给定缓冲区将字节序列写入此通道。

[Android.Runtime.Register("write", "(Ljava/nio/ByteBuffer;)I", "GetWrite_Ljava_nio_ByteBuffer_Handler")]
public abstract int Write(Java.Nio.ByteBuffer? src);
[<Android.Runtime.Register("write", "(Ljava/nio/ByteBuffer;)I", "GetWrite_Ljava_nio_ByteBuffer_Handler")>]
abstract member Write : Java.Nio.ByteBuffer -> int

参数

src
ByteBuffer

包含要写入的字节的字节缓冲区。

返回

写入的字节数,可能为零

实现

特性

例外

如果频道未打开进行写入,则为 。

如果通道已关闭,则为 。

如果另一个线程在写入期间关闭通道,

如果另一个线程在此操作正在进行时中断调用线程, 已设置调用线程的中断状态,并且通道已关闭。

如果发生另一个 I/O 错误,则消息中会显示详细信息。

注解

从给定缓冲区将字节序列写入此通道。

字节从此通道的当前文件位置开始写入,除非通道处于追加模式,在这种情况下,位置首先会提前到文件末尾。 如有必要,文件将增长以适应写入的字节数,然后使用实际写入的字节数更新文件位置。 否则,此方法的行为与接口完全相同 WritableByteChannel 。

适用于 . 的 java.nio.channels.FileChannel.write(java.nio.ByteBuffer)Java 文档

Java参考java.nio.channels.FileChannel.write。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

另请参阅

适用于

Write(ByteBuffer, Int64)

从给定的文件位置开始,从给定的缓冲区写入此通道的字节序列。

[Android.Runtime.Register("write", "(Ljava/nio/ByteBuffer;J)I", "GetWrite_Ljava_nio_ByteBuffer_JHandler")]
public abstract int Write(Java.Nio.ByteBuffer? src, long position);
[<Android.Runtime.Register("write", "(Ljava/nio/ByteBuffer;J)I", "GetWrite_Ljava_nio_ByteBuffer_JHandler")>]
abstract member Write : Java.Nio.ByteBuffer * int64 -> int

参数

src
ByteBuffer

要从中传输字节的缓冲区

position
Int64

要开始传输的文件位置;必须为非负值

返回

写入的字节数,可能为零

特性

例外

如果 position 小于 0,

如果此通道已关闭,则为 。

如果通道未在写入模式下打开,则为 。

如果此方法正在执行时,此通道由另一个线程关闭。

如果另一个线程在此操作正在进行时中断调用线程, 已设置调用线程的中断状态,并且通道已关闭。

如果发生另一个 I/O 错误,则为 。

注解

从给定的文件位置开始,从给定的缓冲区写入此通道的字节序列。

此方法的工作方式与 #write(ByteBuffer) 该方法相同,但从给定文件位置而不是通道当前位置开始写入的字节除外。 此方法不会修改此通道的位置。 如果给定位置大于文件的当前大小,则将增大该文件以适应新字节;未指定上一个文件结束和新写入的字节之间的任何字节的值。

适用于 . 的 java.nio.channels.FileChannel.write(java.nio.ByteBuffer, long)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于