Export (0) Print
Expand All

SpecialDirectories Class

Provides properties for accessing commonly referenced directories.

System.Object
  Microsoft.VisualBasic.FileIO.SpecialDirectories

Namespace:  Microsoft.VisualBasic.FileIO
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

[HostProtectionAttribute(SecurityAction.LinkDemand, Resources = HostProtectionResource.ExternalProcessMgmt)]
public class SpecialDirectories

The SpecialDirectories type exposes the following members.

  NameDescription
Public methodSpecialDirectoriesReturns an instance of the SpecialDirectories class.
Top

  NameDescription
Public propertyStatic memberAllUsersApplicationDataGets a path name pointing to the Application Data directory for the all users.
Public propertyStatic memberCurrentUserApplicationDataGets a path name pointing to the Application Data directory for the current user.
Public propertyStatic memberDesktopGets a path name pointing to the Desktop directory.
Public propertyStatic memberMyDocumentsGets a path name pointing to the My Documents directory.
Public propertyStatic memberMyMusicGets a path name pointing to the My Music directory.
Public propertyStatic memberMyPicturesGets a path name pointing to the My Pictures directory.
Public propertyStatic memberProgramFilesGets a path pointing to the Program Files directory.
Public propertyStatic memberProgramsGets a path name pointing to the Programs directory.
Public propertyStatic memberTempGets a path name pointing to the Temp directory.
Top

  NameDescription
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

If the path for the referenced directory is empty, usually due to the operating system not supporting the directory, a DirectoryNotFoundException exception is thrown.

No backslash (\) appears at the end of the path.

The following table lists examples of tasks involving the My.Computer.FileSystem.SpecialDirectories object.

Availability by Project Type

Project type

Available

Windows Application

Yes

Class Library

Yes

Console Application

Yes

Windows Control Library

Yes

Web Control Library

Yes

Windows Service

Yes

Web Site

Yes

NoteNote

The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: Resources. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.

This example returns the filePath for the user's Desktop directory and displays it.

Dim filePath As String
filePath = My.Computer.FileSystem.SpecialDirectories.Desktop
MsgBox(filePath)

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft