FileChannel 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
用于读取、写入、映射和操作文件的通道。
[Android.Runtime.Register("java/nio/channels/FileChannel", DoNotGenerateAcw=true)]
public abstract class FileChannel : Java.Nio.Channels.Spi.AbstractInterruptibleChannel, IDisposable, Java.Nio.Channels.IGatheringByteChannel, Java.Nio.Channels.IScatteringByteChannel, Java.Nio.Channels.ISeekableByteChannel
[<Android.Runtime.Register("java/nio/channels/FileChannel", DoNotGenerateAcw=true)>]
type FileChannel = class
inherit AbstractInterruptibleChannel
interface IByteChannel
interface IReadableByteChannel
interface IChannel
interface ICloseable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IWritableByteChannel
interface IGatheringByteChannel
interface IScatteringByteChannel
interface ISeekableByteChannel
- 继承
- 特性
- 实现
注解
用于读取、写入、映射和操作文件的通道。
文件通道是 SeekableByteChannel 连接到文件的通道。 它在其文件中 具有当前位置, 可以是和 #position() <i>queried</i>#position(long) <i>modified</i>。 文件本身包含一个可变长度的字节序列,可以读取和写入其当前 #size <i>size</i> 字节。 当将字节写入超过其当前大小时,文件的大小将增加;文件的大小在为 #truncate <i>truncated</i>.. 该文件可能还具有一些关联的 元数据 ,例如访问权限、内容类型和上次修改时间;此类不定义元数据访问的方法。
除了熟悉的字节通道的读取、写入和关闭操作外,此类还定义了以下特定于文件的操作:
<ul>
<li>
字节可能 #read(ByteBuffer, long) read 以 #write(ByteBuffer, long) <i>written</i> 不影响通道当前位置的方式在文件中的绝对位置或处于绝对位置。
</li>
<li>
文件的某个区域可能 #map <i>mapped</i> 直接进入内存;对于大型文件,这通常比调用常规 read 或 write 方法更有效。
</li>
<li>
对文件进行的更新可能是 #force <i>forced out</i> 基础存储设备,确保在系统崩溃时不会丢失数据。
</li>
<li>
可以从文件 #transferTo <i>to some other channel</i>传输字节,并且 #transferFrom <i>vice versa</i>以许多操作系统可以优化的方式直接传输到文件系统缓存或从文件系统缓存中快速传输。
</li>
<li>
文件的区域可能 FileLock <i>locked</i> 禁止其他程序进行访问。
</li>
</ul>
文件通道可供多个并发线程使用。
Channel#close close可以随时调用该方法,由Channel接口指定。 只有一个操作涉及通道的位置,或者可以在任何给定时间更改其文件大小;尝试启动第二个此类操作,而第一个操作仍在进行中,将阻止直到第一个操作完成。 其他操作(特别是采取显式位置的操作)可能会同时继续;事实上,它们是否依赖于基础实现,因此未指定。
保证此类实例提供的文件视图与同一程序中其他实例提供的文件的其他视图保持一致。 但是,此类实例提供的视图可能与其他并发运行的程序看到的视图保持一致,因为基础操作系统执行的缓存以及网络文件系统协议引起的延迟。 无论编写其他程序的语言,以及它们是在同一台计算机上运行还是在其他计算机上运行,都是如此。 任何此类不一致性的确切性质都依赖于系统,因此未指定。
通过调用此类定义的方法之一 #open open 来创建文件通道。 也可以通过调用该对象的方法从现有java.io.FileInputStream#getChannel FileInputStreamjava.io.FileOutputStream#getChannel FileOutputStreamjava.io.RandomAccessFile#getChannel RandomAccessFile对象或对象getChannel获取文件通道,该方法返回连接到同一基础文件的文件通道。 从现有流或随机访问文件获取文件通道的位置,则文件通道的状态与该方法 getChannel 返回通道的对象的状态紧密相连。 更改通道的位置(无论是显式的还是通过读取或写入字节)将更改原始对象的文件位置,反之亦然。 通过文件通道更改文件的长度将更改通过原始对象看到的长度,反之亦然。 通过写入字节更改文件的内容将更改原始对象看到的内容,反之亦然。
“open-mode”>
在各种点上,此类指定“打开以供阅读”、“为写入打开”或“打开以供阅读和写入”的实例是必需的。 通过 java.io.FileInputStream#getChannel getChannel 实例方法获取的 java.io.FileInputStream 通道将打开以供读取。 通过 java.io.FileOutputStream#getChannel getChannel 实例方法获取的 java.io.FileOutputStream 通道将打开以供写入。 最后,如果实例是使用模式java.io.RandomAccessFile#getChannel getChannel创建的实例,则通过java.io.RandomAccessFile实例方法"r"获取的通道将打开进行读取,如果实例是使用模式"rw"创建的,则会打开该通道进行读取和写入。
“append-mode”>
打开进行写入的文件通道可能处于 追加模式,例如,如果从通过调用 java.io.FileOutputStream#FileOutputStream(java.io.File,boolean) FileOutputStream(File,boolean) 构造函数并传递 true 第二个参数创建的文件输出流获取该文件通道。 在此模式下,每次调用相对写入操作都会先将位置提升到文件末尾,然后写入请求的数据。 在单个原子操作中是否推进位置和写入数据是否依赖于系统,因此未指定。
在 1.4 中添加。
Java文档java.nio.channels.FileChannel。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
构造函数
| 名称 | 说明 |
|---|---|
| FileChannel() |
初始化此类的新实例。 |
| FileChannel(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| IsOpen |
如果此通道处于打开状态,则返回 true。 (继承自 AbstractInterruptibleChannel) |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
获取运行时上次分配的状态标志。 (继承自 JavaObject) |
| JniPeerMembers |
获取用于访问此Java绑定成员的 JNI 元数据。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
方法
| 名称 | 说明 |
|---|---|
| Begin() |
标记可能无限期阻止的 I/O 操作的开头。 (继承自 AbstractInterruptibleChannel) |
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| Close() |
关闭此通道。 (继承自 AbstractInterruptibleChannel) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
将此对等方的构造委托给运行时的值管理器。 (继承自 JavaObject) |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
要求值管理器释放此对等方,除非其映射保留此相同的托管实例。 (继承自 JavaObject) |
| End(Boolean) |
标记可能无限期阻止的 I/O 操作的末尾。 (继承自 AbstractInterruptibleChannel) |
| Equals(Object) |
测试另一个托管对等方是否引用同一Java对象。 (继承自 JavaObject) |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| Force(Boolean) |
强制将此通道的文件的任何更新写入包含它的存储设备。 |
| ForceAsync(Boolean) |
在任务中运行同步强制操作,以将文件更新写入到存储设备。 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| ImplCloseChannel() |
关闭此通道。 (继承自 AbstractInterruptibleChannel) |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| Lock() |
获取此通道文件上的独占锁。 |
| Lock(Int64, Int64, Boolean) |
获取此通道文件的给定区域的锁。 |
| Map(FileChannel+MapMode, Int64, Int64) |
将此通道文件的某个区域直接映射到内存中。 |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| Open(IPath, ICollection<IOpenOption>, IFileAttribute[]) |
打开或创建文件,返回文件通道以访问该文件。 |
| Open(IPath, IOpenOption[]) |
打开或创建文件,返回文件通道以访问该文件。 |
| Position() |
返回此通道的文件位置。 |
| Position(Int64) |
设置此通道的文件位置。 |
| Read(ByteBuffer, Int64) |
从此通道读取给定缓冲区中的字节序列,从给定的文件位置开始。 |
| Read(ByteBuffer) |
将此通道中的字节序列读入给定缓冲区。 |
| Read(ByteBuffer[], Int32, Int32) |
将此通道中的字节序列读入给定缓冲区的子序列。 |
| Read(ByteBuffer[]) |
将此通道中的字节序列读入给定缓冲区。 |
| ReadAsync(ByteBuffer, Int64) |
在指定文件偏移量的任务中运行同步读取,而无需更改此通道的当前位置。 |
| ReadAsync(ByteBuffer) |
在任务中运行同步读取,从此通道的当前文件位置开始,并按读取的字节数推进该位置。 |
| ReadAsync(ByteBuffer[], Int32, Int32) |
在任务中运行同步散点读取到所选缓冲区中,通过读取的字节数推进此通道的文件位置。 |
| ReadAsync(ByteBuffer[]) |
在任务中的所有提供的缓冲区中运行同步散点读取,并通过读取的字节数推进此通道的文件位置。 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。 (继承自 JavaObject) |
| Size() |
返回此通道文件的当前大小。 |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| TransferFrom(IReadableByteChannel, Int64, Int64) |
将字节从给定的可读字节通道传输到此通道的文件。 |
| TransferFromAsync(IReadableByteChannel, Int64, Int64) |
在任务中运行从源通道到此文件的同步传输,而无需更改此通道的当前位置。 |
| TransferTo(Int64, Int64, IWritableByteChannel) |
将字节从此通道的文件传输到给定的可写字节通道。 |
| TransferToAsync(Int64, Int64, IWritableByteChannel) |
运行从此文件到任务中目标通道的同步传输,而无需更改此通道的当前位置。 |
| Truncate(Int64) |
将此通道的文件截断为给定大小。 |
| TruncateAsync(Int64) |
在任务中运行同步文件截断操作。 |
| TryLock() |
尝试获取此通道文件上的独占锁。 |
| TryLock(Int64, Int64, Boolean) |
尝试获取此通道文件的给定区域的锁。 |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Wait() |
导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。 (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
| Write(ByteBuffer, Int64) |
从给定的文件位置开始,从给定的缓冲区写入此通道的字节序列。 |
| Write(ByteBuffer) |
从给定缓冲区将字节序列写入此通道。 |
| Write(ByteBuffer[], Int32, Int32) |
从给定缓冲区的子序列将字节序列写入此通道。 |
| Write(ByteBuffer[]) |
从给定缓冲区将字节序列写入此通道。 |
| WriteAsync(ByteBuffer, Int64) |
在指定文件偏移量的任务中运行同步写入,而无需更改此通道的当前位置。 |
| WriteAsync(ByteBuffer) |
在此通道的文件位置或在文件末尾以追加模式运行同步写入,按写入的字节数提升文件位置。 |
| WriteAsync(ByteBuffer[], Int32, Int32) |
在文件位置的任务中或在追加模式下从所选缓冲区运行同步收集写入,并将文件位置提升为写入的字节数。 |
| WriteAsync(ByteBuffer[]) |
在文件位置或追加模式下,从任务中提供的所有缓冲区运行同步收集写入,并将文件位置提升为写入的字节数。 |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
从运行时的Java对象查找中删除此实例。 |
| ISeekableByteChannel.Position(Int64) |
设置此通道的位置。 |
| ISeekableByteChannel.Truncate(Int64) |
截断此通道连接到给定大小的实体。 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| ReadAsync(IReadableByteChannel, ByteBuffer) |
在任务中运行通道的同步读取操作。 |
| ReadAsync(IScatteringByteChannel, ByteBuffer[], Int32, Int32) |
在任务中运行通道的同步散点读取到所选缓冲区中。 |
| ReadAsync(IScatteringByteChannel, ByteBuffer[]) |
运行通道的同步散点读取到任务中的所有提供的缓冲区中。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |
| WriteAsync(IGatheringByteChannel, ByteBuffer[], Int32, Int32) |
从任务中的所选缓冲区运行通道的同步收集写入。 |
| WriteAsync(IGatheringByteChannel, ByteBuffer[]) |
从任务中提供的所有缓冲区运行通道的同步收集写入。 |
| WriteAsync(IWritableByteChannel, ByteBuffer) |
在任务中运行通道的同步写入操作。 |