FileChannel.Read 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| Read(ByteBuffer, Int64) |
从此通道读取给定缓冲区中的字节序列,从给定的文件位置开始。 |
| Read(ByteBuffer) |
将此通道中的字节序列读入给定缓冲区。 |
| Read(ByteBuffer[]) |
将此通道中的字节序列读入给定缓冲区。 |
| Read(ByteBuffer[], Int32, Int32) |
将此通道中的字节序列读入给定缓冲区的子序列。 |
Read(ByteBuffer, Int64)
从此通道读取给定缓冲区中的字节序列,从给定的文件位置开始。
[Android.Runtime.Register("read", "(Ljava/nio/ByteBuffer;J)I", "GetRead_Ljava_nio_ByteBuffer_JHandler")]
public abstract int Read(Java.Nio.ByteBuffer? dst, long position);
[<Android.Runtime.Register("read", "(Ljava/nio/ByteBuffer;J)I", "GetRead_Ljava_nio_ByteBuffer_JHandler")>]
abstract member Read : Java.Nio.ByteBuffer * int64 -> int
参数
- dst
- ByteBuffer
要传输到的字节的缓冲区
- position
- Int64
要开始传输的文件位置;必须为非负值
返回
读取的字节数(可能为零)或 -1 给定位置大于或等于文件的当前大小
- 特性
例外
如果此方法正在执行时,此通道由另一个线程关闭。
如果另一个线程在此操作正在进行时中断调用线程, 调用线程将设置中断状态,通道将关闭。
如果此通道已关闭,则为
如果 position 小于 0,
如果发生另一个 I/O 错误,则为
如果通道尚未在允许读取的模式下打开,
注解
从此通道读取给定缓冲区中的字节序列,从给定的文件位置开始。
此方法的工作方式与 #read(ByteBuffer) 方法相同,不同之处在于从给定文件位置开始读取字节,而不是在通道的当前位置读取。 此方法不会修改此通道的位置。 如果给定位置大于文件的当前大小,则不会读取任何字节。
Java文档java.nio.channels.FileChannel.read(java.nio.ByteBuffer, long)。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
Read(ByteBuffer)
将此通道中的字节序列读入给定缓冲区。
[Android.Runtime.Register("read", "(Ljava/nio/ByteBuffer;)I", "GetRead_Ljava_nio_ByteBuffer_Handler")]
public abstract int Read(Java.Nio.ByteBuffer? dst);
[<Android.Runtime.Register("read", "(Ljava/nio/ByteBuffer;)I", "GetRead_Ljava_nio_ByteBuffer_Handler")>]
abstract member Read : Java.Nio.ByteBuffer -> int
参数
- dst
- ByteBuffer
要传输到的字节的缓冲区
返回
如果通道已达到流结束,则读取的字节数(可能为零)或 -1
实现
- 特性
例外
如果另一个线程在读取期间关闭通道,
如果另一个线程在读取期间中断调用线程,
如果此通道已关闭,则为
如果发生另一个 I/O 错误,则消息中会显示详细信息。
如果通道尚未在允许读取的模式下打开,
注解
将此通道中的字节序列读入给定缓冲区。
从此通道的当前文件位置开始读取字节,然后使用实际读取的字节数更新文件位置。 否则,此方法的行为与接口中指定的 ReadableByteChannel 完全相同。
Java文档java.nio.channels.FileChannel.read(java.nio.ByteBuffer)。
Java参考java.nio.channels.FileChannel.read。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
Read(ByteBuffer[])
将此通道中的字节序列读入给定缓冲区。
[Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;)J", "")]
public long Read(Java.Nio.ByteBuffer[]? dsts);
[<Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;)J", "")>]
abstract member Read : Java.Nio.ByteBuffer[] -> int64
override this.Read : Java.Nio.ByteBuffer[] -> int64
参数
- dsts
- ByteBuffer[]
要传输到的字节的缓冲区
返回
如果通道已达到流结束,则读取的字节数(可能为零)或 -1
实现
- 特性
例外
如果此通道在此读取操作期间由另一个线程关闭,
如果线程在此读取操作期间被另一个线程中断。
如果此通道已关闭,则为
如果发生另一个 I/O 错误,则为详细信息位于消息中。
如果通道尚未在允许读取的模式下打开,
注解
将此通道中的字节序列读入给定缓冲区。
从此通道的当前文件位置开始读取字节,然后使用实际读取的字节数更新文件位置。 否则,此方法的行为与接口中指定的 ScatteringByteChannel 完全相同。
Java文档java.nio.channels.FileChannel.read(java.nio.ByteBuffer[])。
Java参考java.nio.channels.FileChannel.read。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
Read(ByteBuffer[], Int32, Int32)
将此通道中的字节序列读入给定缓冲区的子序列。
[Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;II)J", "GetRead_arrayLjava_nio_ByteBuffer_IIHandler")]
public abstract long Read(Java.Nio.ByteBuffer[]? dsts, int offset, int length);
[<Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;II)J", "GetRead_arrayLjava_nio_ByteBuffer_IIHandler")>]
abstract member Read : Java.Nio.ByteBuffer[] * int * int -> int64
参数
- dsts
- ByteBuffer[]
要传输到的字节的缓冲区
- offset
- Int32
要传输到的第一个缓冲区的缓冲区数组中的偏移量;必须为非负值且不大于 dsts.length
- length
- Int32
要访问的最大缓冲区数;必须为非负值且不大于 dsts.length - 偏移量
返回
如果通道已达到流结束,则读取的字节数(可能为零)或 -1
实现
- 特性
例外
如果此通道在此读取操作期间由另一个线程关闭,
如果线程在此读取操作期间被另一个线程中断。
如果此通道已关闭,则为
如果start 或number 大于其大小start + number,则buffers为
如果发生另一个 I/O 错误,则为详细信息位于消息中。
如果通道尚未在允许读取的模式下打开,
注解
将此通道中的字节序列读入给定缓冲区的子序列。
从此通道的当前文件位置开始读取字节,然后使用实际读取的字节数更新文件位置。 否则,此方法的行为与接口中指定的 ScatteringByteChannel 完全相同。
Java文档java.nio.channels.FileChannel.read(java.nio.ByteBuffer[], int, int)。
Java参考java.nio.channels.FileChannel.read。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。