My.Computer.FileSystem.GetFileInfo メソッド

更新 : 2007 年 11 月

指定されたファイルの FileInfo オブジェクトを返します。

' Usage
Dim value As System.IO.FileInfo = My.Computer.FileSystem.GetFileInfo(file)
' Declaration
Public Function GetFileInfo( _
   ByVal file As String _
) As System.IO.FileInfo

パラメータ

  • file
    ファイルの名前とパスを指定する String です。必ず指定します。

戻り値

FileInfo

例外

次の条件を満たす場合は、例外が発生する可能性があります。

  • パス名の形式に誤りがある場合。たとえば、無効な文字が含まれている場合や、空白だけの場合などです (ArgumentException)。

  • ファイル名に後続のスラッシュ記号が指定されています (ArgumentException)。

  • ファイルが存在しないか Nothing です (ArgumentNullException)。

  • パスの文字列の間にコロンが含まれています (NotSupportedException)。

  • パスが長すぎる場合 (PathTooLongException)

  • ユーザーに必要なアクセス許可がありません (SecurityException)。

  • ユーザーにファイルへの ACL (アクセス制御リスト) のアクセス権がありません (UnauthorizedAccessException)。

解説

ファイルが存在しなくても例外はスローされません。ただし、そのオブジェクトのプロパティが最初にアクセスされたときに例外がスローされます。

処理手順

My.Computer.FileSystem.GetFileInfo メソッドに関連するタスクの例を次の表に示します。

目的

参照項目

ファイルに関する情報の取得

方法 : Visual Basic でファイルについての情報を取得する

ファイルの名前とパスを調べる

方法 : Visual Basic でファイル パスを解析する

使用例

次の例は、 MyLogFile.log ファイルの System.IO.FileInfo オブジェクトを取得し、それを使ってファイルの完全名、最終アクセス日時、および長さを報告します。

Dim information As System.IO.FileInfo
information = My.Computer.FileSystem.GetFileInfo("C:\MyLogFile.log")
MsgBox("The file's full name is " & information.FullName & ".")
MsgBox("Last access time is " & information.LastAccessTime & ".")
MsgBox("The length is " & information.Length & ".")

必要条件

名前空間 : Microsoft.VisualBasic.MyServices

クラス : FileSystemProxy (FileSystem へのアクセスを可能にします)

アセンブリ : Visual Basic ランタイム ライブラリ (Microsoft.VisualBasic.dll 内)

使用可能なプロジェクトの種類

プロジェクトの種類

使用可/不可

Windows アプリケーション

クラス ライブラリ

コンソール アプリケーション

Windows コントロール ライブラリ

Web コントロール ライブラリ

Windows サービス

Web サイト

アクセス許可

次のアクセス許可が必要になる可能性があります。

アクセス許可

説明

FileIOPermission

ファイルとフォルダへのアクセス許可を制御します。関連する列挙値 : Unrestricted

詳細については、「コード アクセス セキュリティ」および「アクセス許可の要求」を参照してください。

参照

処理手順

チュートリアル : Visual Basic によるファイルとディレクトリの操作

参照

My.Computer.FileSystem オブジェクト

System.IO.FileInfo

FileSystem.GetFileInfo

その他の技術情報

Visual Basic におけるファイル、ディレクトリ、およびドライブのプロパティ