This topic has not yet been rated - Rate this topic

SpecialDirectories Class

.NET Framework 4.5

Other Versions

Provides properties for accessing commonly referenced directories.

Inheritance Hierarchy

System.Object
Microsoft.VisualBasic.FileIO.SpecialDirectories

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

Syntax

C++

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

The SpecialDirectories type exposes the following members.

Constructors

	Name	Description
	SpecialDirectories	Returns an instance of the SpecialDirectories class.

Top

Properties

	Name	Description
	AllUsersApplicationData	Gets a path name pointing to the Application Data directory for the all users.
	CurrentUserApplicationData	Gets a path name pointing to the Application Data directory for the current user.
	Desktop	Gets a path name pointing to the Desktop directory.
	MyDocuments	Gets a path name pointing to the My Documents directory.
	MyMusic	Gets a path name pointing to the My Music directory.
	MyPictures	Gets a path name pointing to the My Pictures directory.
	ProgramFiles	Gets a path pointing to the Program Files directory.
	Programs	Gets a path name pointing to the Programs directory.
	Temp	Gets a path name pointing to the Temp directory.

Top

Methods

	Name	Description
	Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Remarks

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.

To	See
Read from the MyDocuments directory	How to: Retrieve the Contents of the My Documents Directory in Visual Basic

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

Note
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.

Note

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.

Examples

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)

Version Information

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

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.

Thread Safety

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

Reference

Microsoft.VisualBasic.FileIO Namespace

FileSystem

Other Resources

Objects (Visual Basic)

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)