FileSystem.GetFileInfo(String) Method

Reference

Definition

Namespace:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns a FileInfo object for the specified file.

public:
 static System::IO::FileInfo ^ GetFileInfo(System::String ^ file);

public static System.IO.FileInfo GetFileInfo (string file);

static member GetFileInfo : string -> System.IO.FileInfo

Public Shared Function GetFileInfo (file As String) As FileInfo

Parameters

file: String

Name and path of the file.

Returns

FileInfo

FileInfo object for the specified file.

Exceptions

ArgumentException

The path name is malformed. For example, it contains invalid characters or is only white space. The file name has a trailing slash mark.

ArgumentNullException

file is Nothing or an empty string.

NotSupportedException

The path contains a colon in the middle of the string.

PathTooLongException

The path is too long.

SecurityException

The user lacks necessary permissions.

UnauthorizedAccessException

The user lacks ACL (access control list) access to the file.

Examples

This example retrieves a System.IO.FileInfo object for the file MyLogFile.log and uses it to report the file's full name, last access time, and length.

Dim 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 & ".")

Remarks

An exception is not thrown if the file does not exist; rather, it will be thrown the first time the object's properties are accessed.

The following table lists an example of a task involving the My.Computer.FileSystem.GetFileInfo method.

To	See
Determine a file's name and path	How to: Parse File Paths in Visual Basic

Applies to