AsynchronousFileChannel.Force(Boolean) メソッド

定義

名前空間:

Java.Nio.Channels

アセンブリ:

Mono.Android.dll

このチャネルのファイルに対する更新を、そのファイルを含むストレージ デバイスに強制的に書き込みます。

[Android.Runtime.Register("force", "(Z)V", "GetForce_ZHandler", ApiSince=26)]
public abstract void Force(bool metaData);

[<Android.Runtime.Register("force", "(Z)V", "GetForce_ZHandler", ApiSince=26)>]
abstract member Force : bool -> unit

パラメーター

metaData

Boolean

true場合、ファイルのコンテンツとメタデータの両方に対する変更を強制的にストレージに書き込むには、このメソッドが必要です。それ以外の場合は、コンテンツの変更を強制的に書き込むだけで済みます。

属性

RegisterAttribute

注釈

このチャネルのファイルに対する更新を、そのファイルを含むストレージ デバイスに強制的に書き込みます。

このチャネルのファイルがローカル ストレージ デバイスに存在する場合、このメソッドが返されるときに、このチャネルが作成されてから、またはこのメソッドが最後に呼び出されてから、ファイルに加えられたすべての変更がそのデバイスに書き込まれることが保証されます。 これは、システムがクラッシュした場合に重要な情報が失われないようにするのに役立ちます。

ファイルがローカル デバイスに存在しない場合、そのような保証は行われません。

metaData パラメーターを使用して、このメソッドが実行するために必要な I/O 操作の数を制限できます。 このパラメーターに false 渡すと、ファイルのコンテンツの更新のみをストレージに書き込む必要があることを示します。 true を渡すと、ファイルのコンテンツとメタデータの両方の更新を書き込む必要があり、通常は少なくとも 1 つの I/O 操作が必要になります。 このパラメーターが実際に何らかの影響を与えるかどうかは、基になるオペレーティング システムに依存するため、指定されていません。

このメソッドを呼び出すと、チャネルが読み取り専用に開かれた場合でも、I/O 操作が発生する可能性があります。 たとえば、一部のオペレーティング システムでは、ファイルのメタデータの一部として最終アクセス時間が維持され、この時刻はファイルが読み取されるたびに更新されます。 これが実際に行われるかどうかはシステムに依存するため、指定されていません。

このメソッドは、このクラスで定義されているメソッドを使用して、このチャネルのファイルに加えられた変更を強制的に行う場合にのみ保証されます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。