FileChannel.Write 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| 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 属性许可证中所述的术语使用。