RandomAccessFile コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| RandomAccessFile(File, String) |
|
| RandomAccessFile(IntPtr, JniHandleOwnership) |
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 |
| RandomAccessFile(String, String) |
指定した名前のファイルから読み取り、必要に応じて書き込むランダム アクセス ファイル ストリームを作成します。 |
RandomAccessFile(File, String)
File引数で指定されたファイルから読み取り、必要に応じて書き込むランダム アクセス ファイル ストリームを作成します。
[Android.Runtime.Register(".ctor", "(Ljava/io/File;Ljava/lang/String;)V", "")]
public RandomAccessFile(Java.IO.File? file, string? mode);[<Android.Runtime.Register(".ctor", "(Ljava/io/File;Ljava/lang/String;)V", "")>]
new Java.IO.RandomAccessFile : Java.IO.File * string -> Java.IO.RandomAccessFileパラメーター
- file
- File
ファイル オブジェクト
- mode
- String
上で説明したように、アクセス モード
- 属性
例外
modeに従ってファイルを開いたり作成したりできない場合は >。
modeが"r"、"rw"、"rws"、または"rwd"でない場合。
注釈
File引数で指定されたファイルから読み取り、必要に応じて書き込むランダム アクセス ファイル ストリームを作成します。 このファイル接続を表す新しい FileDescriptor オブジェクトが作成されます。
"mode"><c>mode</c> 引数は、ファイルを開くアクセス モードを指定します。 許可される値とその意味は次のとおりです。
<table summary="Access mode permitted values and meanings"><tr><th align="left">Value</th><th align="left">Meaning</th></tr><tr><td valign="top">"r"</td><td> 読み取り専用で開きます。 結果のオブジェクトの write メソッドのいずれかを呼び出すと、 java.io.IOException がスローされます。
</td></tr><tr><td valign="top">"rw"</td><td> 読み書き用に開きます。 ファイルがまだ存在しない場合は、ファイルの作成が試行されます。
</td></tr><tr><td valign="top">"rws"</td><td>"rw"と同様に、読み取りと書き込みのために開きます。また、ファイルのコンテンツまたはメタデータに対するすべての更新を、基になるストレージ デバイスに同期的に書き込む必要があります。
</td></tr><trtr><td valign="top">"rwd" </td><td>"rw"と同様に、読み取りと書き込みのために開きます。また、ファイルのコンテンツに対するすべての更新を、基になるストレージ デバイスに同期的に書き込む必要があります。
</td></tr></table>
"rws"モードと"rwd"モードは、java.nio.channels.FileChannel クラスのjava.nio.channels.FileChannel#force(boolean) force(boolean)メソッドとよく似ていますが、trueとfalseの引数をそれぞれ渡します。ただし、常にすべての I/O 操作に適用され、多くの場合、より効率的です。 ファイルがローカルストレージデバイス上にある場合、このクラスのメソッドの呼び出しが返されるときに、その呼び出しによってファイルに加えられたすべての変更がそのデバイスに書き込まれることが保証されます。 これは、システムがクラッシュした場合に重要な情報が失われないようにするのに役立ちます。 ファイルがローカル デバイスに存在しない場合、そのような保証は行われません。
"rwd" モードを使用すると、実行される I/O 操作の数を減らすことができます。
"rwd"を使用するには、ファイルのコンテンツの更新のみをストレージに書き込む必要があります。"rws"を使用するには、ファイルのコンテンツとそのメタデータの両方を更新する必要があります。通常は、少なくとも 1 つの低レベルの I/O 操作が必要です。
セキュリティ マネージャーがある場合、 checkRead メソッドは、 file 引数のパス名を引数として使用して呼び出され、ファイルへの読み取りアクセスが許可されているかどうかを確認します。 モードで書き込みが許可されている場合は、ファイルへの書き込みアクセスが許可されているかどうかを確認するために、セキュリティ マネージャーの checkWrite メソッドも path 引数と共に呼び出されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
RandomAccessFile(IntPtr, JniHandleOwnership)
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。
protected RandomAccessFile(IntPtr javaReference, Android.Runtime.JniHandleOwnership transfer);new Java.IO.RandomAccessFile : nativeint * Android.Runtime.JniHandleOwnership -> Java.IO.RandomAccessFileパラメーター
- transfer
- JniHandleOwnership
JniHandleOwnership処理方法を示すjavaReference
注釈
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
RandomAccessFile(String, String)
指定した名前のファイルから読み取り、必要に応じて書き込むランダム アクセス ファイル ストリームを作成します。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;)V", "")]
public RandomAccessFile(string? name, string? mode);[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;)V", "")>]
new Java.IO.RandomAccessFile : string * string -> Java.IO.RandomAccessFileパラメーター
- name
- String
システム依存ファイル名
- mode
- String
アクセス モード
- 属性
例外
modeに従ってファイルを開いたり作成したりできない場合は >。
modeが"r"、"rw"、"rws"、または"rwd"でない場合。
注釈
指定した名前のファイルから読み取り、必要に応じて書き込むランダム アクセス ファイル ストリームを作成します。 ファイルへの接続を表す新しい FileDescriptor オブジェクトが作成されます。
mode引数は、ファイルを開くアクセス モードを指定します。 許可される値とその意味は、 <c>RandomAccessFile(File,String)</c> コンストラクターに指定されています。
セキュリティ マネージャーがある場合は、 checkRead メソッドが引数として name 引数と共に呼び出され、ファイルへの読み取りアクセスが許可されているかどうかを確認できます。 モードで書き込みが許可されている場合は、ファイルへの書き込みアクセスが許可されているかどうかを確認するために、name引数を引数としてセキュリティ マネージャーの checkWrite メソッドも呼び出されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。