File クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ファイルとディレクトリのパス名の抽象表現。
[Android.Runtime.Register("java/io/File", DoNotGenerateAcw=true)]
public class File : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.IComparable
[<Android.Runtime.Register("java/io/File", DoNotGenerateAcw=true)>]
type File = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IComparable
- 継承
- 属性
- 実装
注釈
ファイルとディレクトリのパス名の抽象的な表現。
ユーザー インターフェイスとオペレーティング システムでは、システム依存 <の em>パス名文字列</em> を使用して、ファイルとディレクトリに名前を付けます。 このクラスは、システムに依存しない抽象的な階層パス名のビューを示します。 <em>抽象パス名</em> には、次の 2 つのコンポーネントがあります。
<ol><li> ディスク ドライブ指定子 "/"
などのオプションのシステム依存 <em>プレフィックス</em> 文字列 UNIX ルート ディレクトリの場合は 、nbsp "\\\\"
&。Microsoft Windows UNC パス名の場合は、<li> 0 個以上の文字列 <em>names</em> のシーケンス。 </Ol>
抽象パス名の最初の名前は、ディレクトリ名、または Microsoft Windows UNC パス名の場合はホスト名です。 抽象パス名内の後続の各名前は、ディレクトリを表します。姓はディレクトリまたはファイルを表します。 <em>empty</em> 抽象パス名には、プレフィックスと空の名前シーケンスがありません。
パス名文字列から抽象パス名への変換と抽象パス名からの変換は、本質的にシステムに依存します。 抽象パス名を pathname 文字列に変換すると、各名前は、既定 <の em>区切り文字</em> の 1 つのコピーによって次の名前から分離されます。 既定の名前区切り文字は、システム プロパティ file.separator
によって定義され、パブリック静的フィールド {@link #separator}
および {@link #separatorChar}
このクラスで使用できます。 パス名文字列を抽象パス名に変換する場合、その中の名前は、既定の名前区切り文字または基になるシステムでサポートされている他の名前区切り文字で区切られます。
パス名は、抽象形式でも文字列形式でも、em>absolute/em> または <em>relative</em> のいずれか<<です。 絶対パス名は、それが示すファイルを見つけるために他の情報が必要ない点で完全です。 これに対し、相対パス名は、他のパス名から取得された情報の観点から解釈する必要があります。 既定では、パッケージ内のクラスは常に現在の java.io
ユーザー ディレクトリに対する相対パス名を解決します。 このディレクトリは、システム プロパティ user.dir
によって名前が付けられ、通常は Java 仮想マシンが呼び出されたディレクトリです。
抽象パス名の em>parent</em> は<、このクラスの メソッドを#getParent
呼び出すことによって取得でき、パス名のプレフィックスと、パス名の名前シーケンス内の各名前で構成されます。ただし、最後の を除きます。 各ディレクトリの絶対パス名は、ディレクトリの絶対パス名で始まる絶対抽象パス名を持つ任意 File
のオブジェクトの先祖です。 たとえば、抽象パス名で示されるディレクトリは、pathname "/usr"
で示されるディレクトリの先祖です "/usr/local/bin"
。
プレフィックスの概念は、次のように、UNIX プラットフォームのルート ディレクトリ、および Microsoft Windows プラットフォームのドライブ指定子、ルート ディレクトリ、UNC パス名を処理するために使用されます。
<ul>
<li> UNIX プラットフォームの場合、絶対パス名のプレフィックスは常に "/"
です。 相対パス名にはプレフィックスがありません。 ルート ディレクトリを示す抽象パス名には、プレフィックス "/"
と空の名前シーケンスがあります。
<li> Microsoft Windows プラットフォームの場合、ドライブ指定子を含む pathname のプレフィックスは、ドライブ文字の後に が続き ":"
、pathname が絶対である場合は 後に "\\"
続く可能性があります。 UNC パス名のプレフィックスは です "\\\\"
。ホスト名と共有名は、名前シーケンスの最初の 2 つの名前です。 ドライブを指定しない相対パス名にはプレフィックスがありません。
</ul>
このクラスのインスタンスは、ファイルやディレクトリなどの実際のファイル システム オブジェクトを示す場合とそうでない場合があります。 そのようなオブジェクトを示す場合、そのオブジェクトは パーティションに存在します。 パーティションは、ファイル システムのストレージのオペレーティング システム固有の部分です。 1 つのストレージ デバイス (物理ディスク ドライブ、フラッシュ メモリ、CD-ROM など) には、複数のパーティションが含まれている場合があります。 オブジェクトがある場合、このパス名の絶対形式の先祖によって名前が付けられたパーティション "partName"> に存在します。
ファイル システムでは、読み取り、書き込み、実行など、実際のファイル システム オブジェクトに対する特定の操作に制限を実装できます。 これらの制限は、総称して アクセス許可と呼ばれます。 ファイル システムには、1 つのオブジェクトに対するアクセス許可のセットが複数ある場合があります。 たとえば、1 つのセットがオブジェクトの 所有者に適用され、別のセットが他のすべてのユーザーに適用される場合があります。 オブジェクトに対するアクセス許可により、このクラスの一部のメソッドが失敗する可能性があります。
クラスの File
インスタンスは変更できません。つまり、作成されると、オブジェクトによって File
表される抽象パス名は変更されません。
<h3>パッケージ</h3 とのjava.nio.file
相互運用性>
c>java.nio.file</c> パッケージは<、Java 仮想マシンがファイル、ファイル属性、およびファイル システムにアクセスするためのインターフェイスとクラスを定義します。 この API は、 クラスの制限 java.io.File
事項の多くを克服するために使用できます。 メソッドは#toPath toPath
、 オブジェクトによって表される抽象パスを使用してファイルをFile
検索する を取得Path
するために使用できます。 結果 Path
は、 クラスと共 java.nio.file.Files
に使用して、ファイルに対する操作が失敗したときにエラーを診断するのに役立つ、追加のファイル操作、ファイル属性、および I/O 例外へのより効率的で広範なアクセスを提供するために使用できます。
Android では、オペレーティング システムにファイル名を送信するときに UTF-8 バイト シーケンスに変換され、オペレーティング システムによって返されるバイト シーケンス (さまざまな list
メソッドから) は、UTF-8 バイト シーケンスとしてデコードすることで文字列に変換されます。
JDK1.0 に追加されました。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。
コンストラクター
File(File, String) |
親抽象パス名と子パス名文字列から新しい |
File(IntPtr, JniHandleOwnership) |
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 |
File(String) |
指定した pathname 文字列を抽象パス名に変換して、新しい |
File(String, String) |
親パス名文字列と子パス名文字列から新しい |
File(URI) |
指定 |
プロパティ
AbsoluteFile |
この抽象パス名の絶対形式を返します。 |
AbsolutePath |
このファイルの絶対パスを返します。 |
CanonicalFile |
この抽象パス名の正規形式を返します。 |
CanonicalPath |
この抽象パス名の正規パス名文字列を返します。 |
Class |
この |
FreeSpace |
この抽象パス名によって指定されたパーティション内の未割り当てバイト数を返します。 |
Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
IsAbsolute |
この抽象パス名が絶対であるかどうかをテストします。 |
IsDirectory |
この抽象パス名で示されるファイルがディレクトリであるかどうかをテストします。 |
IsFile |
この抽象パス名で示されるファイルが通常のファイルであるかどうかをテストします。 |
IsHidden |
この抽象パス名によって名前が付けられたファイルが非表示ファイルであるかどうかをテストします。 |
JniIdentityHashCode |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
JniPeerMembers |
ファイルとディレクトリのパス名の抽象表現。 |
Name |
この抽象パス名で示されるファイルまたはディレクトリの名前を返します。 |
Parent |
この抽象パス名の親の pathname 文字列を返します。または |
ParentFile |
この抽象パス名の親の抽象パス名を返します。または |
Path |
この抽象パス名を pathname 文字列に変換します。 |
PathSeparator |
便宜上、文字列として表されるシステム依存のパス区切り文字。 |
PathSeparatorChar |
システム依存のパス区切り文字。 |
PeerReference |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
Separator |
便宜上、文字列として表される、システム依存の既定の名前区切り文字。 |
SeparatorChar |
システム依存の既定の名前区切り文字。 |
ThresholdClass |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。 |
ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。 |
TotalSpace |
この抽象パス名で指定されたパーティションのサイズを返します。 |
UsableSpace |
この抽象パス名で指定されたパーティションで、この仮想マシンで使用できるバイト数を返します。 |
メソッド
CanExecute() |
この抽象パス名で示されるファイルをアプリケーションで実行できるかどうかをテストします。 |
CanRead() |
この抽象パス名で示されるファイルをアプリケーションが読み取ることができるかどうかをテストします。 |
CanWrite() |
この抽象パス名で示されるファイルをアプリケーションが変更できるかどうかをテストします。 |
Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
CompareTo(File) |
2 つの抽象パス名を辞書式で比較します。 |
CreateNewFile() |
この名前のファイルがまだ存在しない場合にのみ、この抽象パス名によって名前が付けられた新しい空のファイルをアトミックに作成します。 |
CreateTempFile(String, String) |
指定したプレフィックスとサフィックスを使用して名前を生成し、既定の一時ファイル ディレクトリに空のファイルを作成します。 |
CreateTempFile(String, String, File) |
指定したプレフィックスとサフィックス文字列を使用して、指定したディレクトリに新しい空のファイルを作成し、その名前を生成します。 |
Delete() |
この抽象パス名で示されるファイルまたはディレクトリを削除します。 |
DeleteOnExit() |
仮想マシンが終了したときに、この抽象パス名で示されるファイルまたはディレクトリを削除することを要求します。 |
Dispose() |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
Dispose(Boolean) |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
Exists() |
この抽象パス名で示されるファイルまたはディレクトリが存在するかどうかをテストします。 |
GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
JavaFinalize() |
ガベージ コレクションがオブジェクトへの参照がなくなったと判断したときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
LastModified() |
この抽象パス名で示されるファイルが最後に変更された時刻を返します。 |
Length() |
この抽象パス名で示されるファイルの長さを返します。 |
List() |
この抽象パス名で示されるディレクトリ内のファイルとディレクトリに名前を付ける文字列の配列を返します。 |
List(IFilenameFilter) |
指定したフィルターを満たすこの抽象パス名で示されるディレクトリ内のファイルとディレクトリに名前を付ける文字列の配列を返します。 |
ListAsync() |
ファイルとディレクトリのパス名の抽象表現。 |
ListAsync(IFilenameFilter) |
ファイルとディレクトリのパス名の抽象表現。 |
ListFiles() |
この抽象パス名で示されるディレクトリ内のファイルを示す抽象パス名の配列を返します。 |
ListFiles(IFileFilter) |
指定したフィルターを満たすこの抽象パス名で示されるディレクトリ内のファイルとディレクトリを示す抽象パス名の配列を返します。 |
ListFiles(IFilenameFilter) |
指定したフィルターを満たすこの抽象パス名で示されるディレクトリ内のファイルとディレクトリを示す抽象パス名の配列を返します。 |
ListFilesAsync() |
ファイルとディレクトリのパス名の抽象表現。 |
ListFilesAsync(IFileFilter) |
ファイルとディレクトリのパス名の抽象表現。 |
ListFilesAsync(IFilenameFilter) |
ファイルとディレクトリのパス名の抽象表現。 |
ListRoots() |
ファイル システム ルートを返します。 |
ListRootsAsync() |
ファイルとディレクトリのパス名の抽象表現。 |
Mkdir() |
この抽象パス名によって名前が付けられたディレクトリを作成します。 |
Mkdirs() |
必要だが存在しない親ディレクトリを含め、この抽象パス名によって名前付けされたディレクトリを作成します。 |
Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドをウェイクアップします。 (継承元 Object) |
NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドをウェイクアップします。 (継承元 Object) |
RenameTo(File) |
この抽象パス名で示されるファイルの名前を変更します。 |
SetExecutable(Boolean) |
この抽象パス名に対する所有者の実行アクセス許可を設定する便利なメソッド。 |
SetExecutable(Boolean, Boolean) |
この抽象パス名に対する所有者またはすべてのユーザーの実行アクセス許可を設定します。 |
SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
SetLastModified(Int64) |
この抽象パス名によって名前が付けられたファイルまたはディレクトリの最終変更時刻を設定します。 |
SetReadable(Boolean) |
この抽象パス名に対する所有者の読み取りアクセス許可を設定する便利なメソッド。 |
SetReadable(Boolean, Boolean) |
この抽象パス名に対する所有者またはすべてのユーザーの読み取りアクセス許可を設定します。 |
SetReadOnly() |
この抽象パス名によって名前が付けられたファイルまたはディレクトリをマークして、読み取り操作のみが許可されるようにします。 |
SetWritable(Boolean) |
この抽象パス名に対する所有者の書き込みアクセス許可を設定する便利なメソッド。 |
SetWritable(Boolean, Boolean) |
この抽象パス名に対する所有者またはすべてのユーザーの書き込みアクセス許可を設定します。 |
ToArray<T>() |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
ToPath() |
|
ToString() |
オブジェクトの文字列形式を返します。 (継承元 Object) |
ToURI() |
この抽象パス名を |
ToURL() |
古い.
この抽象パス名を URL に |
UnregisterFromRuntime() |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
Wait() |
現在のスレッドが起動するまで待機します。通常<>は、通知</em> または <em>割り込み</em によって待機します>。 (継承元 Object) |
Wait(Int64) |
現在のスレッドが起動するまで待機します。通常<>は、通知</em> または>< em 割り込み</em>、または一定のリアルタイムが経過するまで待機します。 (継承元 Object) |
Wait(Int64, Int32) |
現在のスレッドが起動するまで待機します。通常<>は、通知</em> または>< em 割り込み</em>、または一定のリアルタイムが経過するまで待機します。 (継承元 Object) |
明示的なインターフェイスの実装
IComparable.CompareTo(Object) |
ファイルとディレクトリのパス名の抽象表現。 |
IJavaPeerable.Disposed() |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
IJavaPeerable.DisposeUnlessReferenced() |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
IJavaPeerable.Finalized() |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
IJavaPeerable.JniManagedPeerState |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
IJavaPeerable.SetPeerReference(JniObjectReference) |
ファイルとディレクトリのパス名の抽象表現。 (継承元 Object) |
拡張メソッド
JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
JavaCast<TResult>(IJavaObject) |
ファイルとディレクトリのパス名の抽象表現。 |
GetJniTypeName(IJavaPeerable) |
ファイルとディレクトリのパス名の抽象表現。 |