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
転送を開始するファイルの位置。は負以外である必要があります
返品
指定した位置がファイルの現在のサイズ以上の場合は、読み取られたバイト数、場合によっては 0 バイト、または-1
- 属性
例外
このメソッドの実行中に、このチャネルが別のスレッドによって閉じられた場合は 。
この操作の進行中に別のスレッドが呼び出し元のスレッドを中断した場合。 呼び出し元のスレッドに割り込み状態が設定され、チャネルが閉じられます。
このチャネルが閉じている場合は〘。
positionが 0 未満の場合。
別の I/O エラーが発生した場合は〘。
読み取りを許可するモードでチャネルが開かっていない場合は 。
注釈
指定されたファイル位置から開始して、このチャネルから特定のバッファーにバイトシーケンスを読み取ります。
このメソッドは、チャネルの現在位置ではなく、指定されたファイル位置からバイトが読み取られますが、 #read(ByteBuffer) メソッドと同じ方法で動作します。 このメソッドは、このチャネルの位置を変更しません。 指定された位置がファイルの現在のサイズより大きい場合、バイトは読み取われません。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
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
返品
実装
- 属性
例外
読み取り中に別のスレッドがチャネルを閉じる場合。
読み取り中に別のスレッドが呼び出し元のスレッドを中断する場合。
このチャネルが閉じている場合は〘。
別の I/O エラーが発生した場合は、メッセージに詳細が表示されます。
読み取りを許可するモードでチャネルが開かっていない場合は 。
注釈
このチャネルから特定のバッファーにバイト シーケンスを読み取ります。
バイトは、このチャネルの現在のファイル位置から読み取られ、実際に読み取られたバイト数でファイル位置が更新されます。 それ以外の場合、このメソッドは、 ReadableByteChannel インターフェイスで指定されたとおりに動作します。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
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[]
返品
実装
- 属性
例外
この読み取り操作中にこのチャネルが別のスレッドによって閉じられた場合は 。
この読み取り操作中にスレッドが別のスレッドによって中断された場合。
このチャネルが閉じている場合は〘。
別の I/O エラーが発生した場合。詳細がメッセージに表示されます。
読み取りを許可するモードでチャネルが開かっていない場合は 。
注釈
このチャネルから特定のバッファーにバイトシーケンスを読み取ります。
バイトは、このチャネルの現在のファイル位置から読み取られ、実際に読み取られたバイト数でファイル位置が更新されます。 それ以外の場合、このメソッドは、 ScatteringByteChannel インターフェイスで指定されたとおりに動作します。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
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
- length
- Int32
返品
実装
- 属性
例外
この読み取り操作中にこのチャネルが別のスレッドによって閉じられた場合は 。
この読み取り操作中にスレッドが別のスレッドによって中断された場合。
このチャネルが閉じている場合は〘。
start またはnumber の場合、またはstart + numberがbuffersのサイズより大きい場合。
別の I/O エラーが発生した場合。詳細がメッセージに表示されます。
読み取りを許可するモードでチャネルが開かっていない場合は 。
注釈
このチャネルから特定のバッファーのサブシーケンスにバイトシーケンスを読み取ります。
バイトは、このチャネルの現在のファイル位置から読み取られ、実際に読み取られたバイト数でファイル位置が更新されます。 それ以外の場合、このメソッドは、 ScatteringByteChannel インターフェイスで指定されたとおりに動作します。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。