语言

FileChannel.Read 方法

定义

重载

名称 说明
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。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于