FileSystemInfo クラス

.NET Framework クラス ライブラリ リファレンス

FileSystemInfo クラス

FileInfo オブジェクトと DirectoryInfo オブジェクトの両方の基本クラスを提供します。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public MustInherit Class
 FileSystemInfo
    Inherits MarshalByRefObject
    Implements ISerializable

Visual Basic (使用法)

Dim instance As FileSystemInfo

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public abstract class FileSystemInfo : MarshalByRefObject,
 ISerializable

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class FileSystemInfo abstract :
 public MarshalByRefObject, ISerializable

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public abstract class FileSystemInfo extends
 MarshalByRefObject implements ISerializable

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public abstract class FileSystemInfo extends
 MarshalByRefObject implements ISerializable

解説

FileSystemInfo クラスには、ファイルとディレクトリの操作のために一般的に使用されるメソッドが含まれています。FileSystemInfo オブジェクトは、ファイルまたはディレクトリのいずれでも表すことができるため、FileInfo オブジェクトまたは DirectoryInfo オブジェクトの基盤として機能します。多数のファイルとディレクトリを解析する場合は、この基本クラスを使用します。

FileSystemInfo では、最初に呼び出されたときに Refresh を呼び出し、属性の取得などを行う API に関するキャッシュされた情報を返します。以降の呼び出しでは、Refresh を呼び出して、最新の情報を取得する必要があります。

派生クラスは、FileIOPermissionAccess 列挙体からの AllAccess アクセス許可を持つ場合にだけ、FileSystemInfo から継承できます。

パスを受け入れるメンバでは、ファイルまたはディレクトリを参照するパスを指定できます。指定するパスは、相対パス、またはサーバーおよび共有名を示す UNC (Universal Naming Convention) パスにすることができます。たとえば、次に示すパスはすべて有効なパスです。

• C# では "c:\\MyDir\\MyFile.txt"、Visual Basic では "c:\MyDir\MyFile.txt"。

• C# では "c:\\MyDir"、Visual Basic では "c:\MyDir"。

• C# では "MyDir\\MySubdir"、Visual Basic では "MyDir\MySubDir"。

• C# では "\\\\MyServer\\MyShare"、Visual Basic では "\\MyServer\MyShare"。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキスト ファイルを作成する。	方法 : ファイルにテキストを書き込む
テキスト ファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキスト ファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログ ファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ディレクトリを作成する。	Directory.CreateDirectory System.IO.DirectoryInfo
サブディレクトリを作成する。	CreateSubdirectory
ディレクトリの名前を変更、またはディレクトリを移動する。	Directory.Move DirectoryInfo.MoveTo
ディレクトリを削除する。	Directory.Delete DirectoryInfo.Delete
ディレクトリをコピーする。	Directory
ディレクトリ内のファイルをサイズ順に並べ替える。	GetFileSystemInfos
ディレクトリ内のファイルを参照する。	Name
ディレクトリ内のサブディレクトリを参照する。	GetDirectories GetDirectories
ディレクトリ内のすべてのサブディレクトリにあるすべてのファイルを参照する。	GetFileSystemInfos
ディレクトリのサイズを取得する。	Directory
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリ ファイルから読み取る。	方法 : 新しく作成されたデータ ファイルに対して読み書きする
バイナリ ファイルに書き込む。	方法 : 新しく作成されたデータ ファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

使用例

すべてのファイルおよびディレクトリをループして、各エントリに関する情報を照会する方法の例を次に示します。

Visual Basic

Imports System.IO
Module Module1

    Sub Main()
        ' Loop through all the immediate subdirectories of C.
        For Each entry As
 String In Directory.GetDirectories("C:\")
            DisplayFileSystemInfoAttributes(New DirectoryInfo(entry))
        Next

        ' Loop through all the files in C.
        For Each entry As
 String In Directory.GetFiles("C:\")
            DisplayFileSystemInfoAttributes(New FileInfo(entry))
        Next
    End Sub

    Sub DisplayFileSystemInfoAttributes(ByVal
 fsi As IO.FileSystemInfo)
        ' Assume that this entry is a file.
        Dim entryType As String
 = "File"

        ' Determine if this entry is really a directory.
        If (fsi.Attributes And FileAttributes.Directory)
 <> 0 Then
            entryType = "Directory"
        End If

        ' Show this entry's type, name, and creation date.
        Console.WriteLine("{0} entry {1} was created on {2:D}",
 _
            entryType, fsi.FullName, fsi.CreationTime)
    End Sub
End Module

' Output will vary based on contents of drive C.
' 
' Directory entry C:\Documents and Settings was created on Tuesday,
 November 25, 2003
' Directory entry C:\Inetpub was created on Monday, January 12, 2004
' Directory entry C:\Program Files was created on Tuesday, November
 25, 2003
' Directory entry C:\RECYCLER was created on Tuesday, November 25, 2003
' Directory entry C:\System Volume Information was created on Tuesday,
 November 2, 2003
' Directory entry C:\WINDOWS was created on Tuesday, November 25, 2003
' File entry C:\IO.SYS was created on Tuesday, November 25, 2003
' File entry C:\MSDOS.SYS was created on Tuesday, November 25, 2003
' File entry C:\pagefile.sys was created on Saturday, December 27, 2003

.NET Framework のセキュリティ

• FileIOPermission  Unrestricted (関連する列挙体) InheritanceDemand (セキュリティ アクション) 。 (このクラスから継承するためのアクセス許可)。

継承階層

System.Object
   System.MarshalByRefObject
    System.IO.FileSystemInfo
       System.IO.DirectoryInfo
       System.IO.FileInfo

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
FileSystemInfo メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む
基本のファイル I/O
方法 : 新しく作成されたデータ ファイルに対して読み書きする