File クラス

定義

[Android.Runtime.Register("java/io/File", DoNotGenerateAcw=true)]
public class File : Java.Lang.Object, IDisposable, 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

継承

Object

JavaObject

Object

File

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable ISerializable IComparable IDisposable

注釈

ファイルとディレクトリのパス名の抽象表現。

ユーザー インターフェイスとオペレーティング システムでは、システム依存の <em>pathname 文字列</em> を使用して、ファイルとディレクトリに名前を付けます。 このクラスは、階層パス名のシステムに依存しない抽象ビューを提供します。 <em>abstract pathname</em> には、次の 2 つのコンポーネントがあります。

olli オプションのシステム依存emprefix/em 文字列 (ディスク ドライブ指定子、& など)nbsp;UNIX ルート ディレクトリ、または Microsoft Windows UNC パス名と li 0 個以上の文字列 emnames/em のシーケンス。 </ol>

抽象パス名の名は、ディレクトリ名、または UNC パス名Microsoft Windows場合はホスト名です。 抽象パス名内の後続の各名前はディレクトリを表します。姓はディレクトリまたはファイルを表します。 <em>empty</em>抽象パス名にはプレフィックスと空の名前シーケンスがありません。

パス名文字列から抽象パス名への変換または抽象パス名からの変換は、本質的にシステムに依存します。 抽象パス名をパス名文字列に変換すると、各名前は既定の <em>separator 文字</em>の 1 つのコピーで区切られます。 既定の名前区切り文字は、システム プロパティ file.separatorによって定義され、このクラスの {@link #separator} および {@link #separatorChar} パブリック静的フィールドで使用できます。 パス名文字列を抽象パス名に変換する場合、その中の名前は、既定の名前区切り文字または基になるシステムでサポートされている他の名前区切り文字で区切られます。

パス名は、抽象形式でも文字列形式でも、 <em>absolute</em> または <em>relative</em> のいずれかです。 絶対パス名は、それが示すファイルを見つけるために他の情報が必要ないという点で完全です。 これに対し、相対パス名は、他のパス名から取得された情報の観点から解釈する必要があります。 既定では、 java.io パッケージ内のクラスは、常に現在のユーザー ディレクトリに対する相対パス名を解決します。 このディレクトリは、システム プロパティ user.dirによって名前が付けられ、通常は、Java仮想マシンが呼び出されたディレクトリです。

抽象パス名の <em>parent</em> は、このクラスの #getParent メソッドを呼び出すことによって取得でき、パス名のプレフィックスとパス名の名前シーケンス内の各名前で構成されます。ただし、最後のパス名は除きます。 各ディレクトリの絶対パス名は、ディレクトリの絶対パス名で始まる絶対抽象パス名を持つ任意の File オブジェクトの先祖です。 たとえば、抽象パス名 "/usr" で示されるディレクトリは、パス名 "/usr/local/bin"で示されるディレクトリの先祖です。

プレフィックスの概念は、次のように、UNIX プラットフォームのルート ディレクトリ、およびドライブ指定子、ルート ディレクトリ、および UNC パス名Microsoft Windowsプラットフォームで処理するために使用されます。

<ul>

<li> UNIX プラットフォームの場合、絶対パス名のプレフィックスは常に "/"。 相対パス名にはプレフィックスがありません。 ルート ディレクトリを示す抽象パス名には、プレフィックス "/" と空の名前シーケンスがあります。

<li> Microsoft Windows プラットフォームの場合、ドライブ指定子を含むパス名のプレフィックスは、ドライブ文字の後に":"が続き、パス名が絶対である場合は"\\"で構成されます。 UNC パス名のプレフィックスは "\\\\"。ホスト名と共有名は、名前シーケンスの最初の 2 つの名前です。 ドライブを指定しない相対パス名にプレフィックスがありません。

</ul>

このクラスのインスタンスは、ファイルやディレクトリなどの実際のファイル システム オブジェクトを表す場合と、示されていない場合があります。 そのようなオブジェクトを示す場合、そのオブジェクトは パーティション内に存在します。 パーティションは、ファイル システムのストレージのオペレーティング システム固有の部分です。 1 つのストレージ デバイス (物理ディスク ドライブ、フラッシュ メモリ、CD-ROMなど) には、複数のパーティションが含まれている場合があります。 存在する場合、オブジェクトは、このパス名の絶対形式の一部の先祖によって名前が付>パーティション "partName" に存在します。

ファイル システムでは、読み取り、書き込み、実行など、実際のファイル システム オブジェクトに対する特定の操作に制限を実装できます。 これらの制限は、まとめて アクセス許可と呼ばれます。 ファイル システムには、1 つのオブジェクトに対するアクセス許可のセットが複数ある場合があります。 たとえば、1 つのセットがオブジェクトの 所有者に適用され、別のセットが他のすべてのユーザーに適用される場合があります。 オブジェクトに対するアクセス許可により、このクラスの一部のメソッドが失敗する可能性があります。

File クラスのインスタンスは不変です。つまり、作成されると、File オブジェクトによって表される抽象パス名は変更されません。

<h3>java.nio.file パッケージとの相互運用</h3>

<c>java.nio.file</c> パッケージは、Java仮想マシンがファイル、ファイル属性、ファイル システムにアクセスするためのインターフェイスとクラスを定義します。 この API は、 java.io.File クラスの制限事項の多くを克服するために使用できます。 #toPath toPath メソッドは、Path オブジェクトによって表される抽象パスを使用してファイルを検索するFileを取得するために使用できます。 結果として得られる Path は、 java.nio.file.Files クラスと共に使用して、ファイル操作、ファイル属性、および I/O 例外へのより効率的で広範なアクセスを提供し、ファイルに対する操作が失敗した場合のエラーの診断に役立ちます。

Android では、オペレーティング システムにファイル名を送信するときに UTF-8 バイト シーケンスに変換され、オペレーティング システムによって返されるバイト シーケンス (さまざまな list メソッドから) は、UTF-8 バイト シーケンスとしてデコードすることで文字列に変換されます。

JDK1.0 に追加されました。

Javaドキュメント。

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