IScatteringByteChannel.Read 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| Read(ByteBuffer[]) |
将此通道中的字节序列读入给定缓冲区。 |
| Read(ByteBuffer[], Int32, Int32) |
将此通道中的字节序列读入给定缓冲区的子序列。 |
Read(ByteBuffer[])
将此通道中的字节序列读入给定缓冲区。
[Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;)J", "GetRead_arrayLjava_nio_ByteBuffer_Handler:Java.Nio.Channels.IScatteringByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public long Read(Java.Nio.ByteBuffer[]? dsts);
[<Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;)J", "GetRead_arrayLjava_nio_ByteBuffer_Handler:Java.Nio.Channels.IScatteringByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member Read : Java.Nio.ByteBuffer[] -> int64
参数
- dsts
- ByteBuffer[]
要传输到的字节的缓冲区
返回
读取的字节数(可能为零)或 -1 通道是否已到达流端
- 属性
例外
如果通道在此读取操作期间由另一个线程关闭,
如果另一个线程在操作正在进行时中断调用线程, 已设置调用线程的中断状态,并且通道已关闭。
如果通道已关闭,则为
如果发生另一个 I/O 错误,则为详细信息位于消息中。
如果通道尚未在允许读取的模式下打开,
注解
将此通道中的字节序列读入给定缓冲区。
对窗体 c.read(dsts) 的此方法的调用的行为方式与调用方式完全相同
<blockquote>
c.read(dsts, 0, dsts.length);
</blockquote>
Java文档java.nio.channels.ScatteringByteChannel.read(java.nio.ByteBuffer[])。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
Read(ByteBuffer[], Int32, Int32)
将此通道中的字节序列读入给定缓冲区的子序列。
[Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;II)J", "GetRead_arrayLjava_nio_ByteBuffer_IIHandler:Java.Nio.Channels.IScatteringByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public long Read(Java.Nio.ByteBuffer[]? dsts, int offset, int length);
[<Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;II)J", "GetRead_arrayLjava_nio_ByteBuffer_IIHandler:Java.Nio.Channels.IScatteringByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member Read : Java.Nio.ByteBuffer[] * int * int -> int64
参数
- dsts
- ByteBuffer[]
要传输到的字节的缓冲区
- offset
- Int32
要传输到的第一个缓冲区的缓冲区数组中的偏移量;必须为非负值且不大于 dsts.length
- length
- Int32
要访问的最大缓冲区数;必须为非负值且不大于 dsts.length - offset
返回
读取的字节数(可能为零)或 -1 通道是否已到达流端
- 属性
例外
如果通道在此读取操作期间由另一个线程关闭,
如果另一个线程在操作正在进行时中断调用线程, 已设置调用线程的中断状态,并且通道已关闭。
如果通道已关闭,则为
如果offset 或length 大于其大小offset + length,则buffers为
如果发生另一个 I/O 错误,则为详细信息位于消息中。
如果通道尚未在允许读取的模式下打开,
注解
将此通道中的字节序列读入给定缓冲区的子序列。
此方法的调用尝试从此通道读取最多 r 字节,其中 r 是给定缓冲区数组的指定子序列剩余的字节总数,即,
<blockquote>
dsts[offset].remaining()
+ dsts[offset+1].remaining()
+ ... + dsts[offset+length-1].remaining()
</blockquote>
在调用此方法时。
假设读取长度 n 的字节序列,其中 0 <= n <= r. 最多将此序列的第一 dsts[offset].remaining() 个字节传输到缓冲区 dsts[offset]中,直到整个字节序列传输到给定缓冲区,直到将下一 dsts[offset+1].remaining() 个字节传输到缓冲区 dsts[offset+1],依此类推。 将尽可能多的字节传输到每个缓冲区中,因此,每个更新缓冲区(上次更新的缓冲区除外)的最终位置保证等于该缓冲区的限制。
可以随时调用此方法。 但是,如果另一个线程已在此通道上启动读取操作,则此方法的调用将阻止,直到第一个操作完成。
Java文档java.nio.channels.ScatteringByteChannel.read(java.nio.ByteBuffer[], int, int)。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。