1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.IO.FileSystem.DriveInfo</name>
6 <member name="T:System.IO.DriveInfo">
7 <summary>Provides access to information on a drive.</summary>
9 <member name="M:System.IO.DriveInfo.#ctor(System.String)">
10 <summary>Provides access to information on the specified drive.</summary>
11 <param name="driveName">A valid drive path or drive letter. This can be either uppercase or lowercase, &#39;a&#39; to &#39;z&#39;. A null value is not valid.</param>
12 <exception cref="T:System.ArgumentNullException">The drive letter cannot be null.</exception>
13 <exception cref="T:System.ArgumentException">The first letter of <paramref name="driveName">driveName</paramref> is not an uppercase or lowercase letter from &#39;a&#39; to &#39;z&#39;.
15 <paramref name="driveName">driveName</paramref> does not refer to a valid drive.</exception>
17 <member name="P:System.IO.DriveInfo.AvailableFreeSpace">
18 <summary>Indicates the amount of available free space on a drive, in bytes.</summary>
19 <returns>The amount of free space available on the drive, in bytes.</returns>
20 <exception cref="T:System.UnauthorizedAccessException">Access to the drive information is denied.</exception>
21 <exception cref="T:System.IO.IOException">An I/O error occurred (for example, a disk error or a drive was not ready).</exception>
23 <member name="P:System.IO.DriveInfo.DriveFormat">
24 <summary>Gets the name of the file system, such as NTFS or FAT32.</summary>
25 <returns>The name of the file system on the specified drive.</returns>
26 <exception cref="T:System.UnauthorizedAccessException">Access to the drive information is denied.</exception>
27 <exception cref="T:System.IO.DriveNotFoundException">The drive does not exist or is not mapped.</exception>
28 <exception cref="T:System.IO.IOException">An I/O error occurred (for example, a disk error or a drive was not ready).</exception>
30 <member name="P:System.IO.DriveInfo.DriveType">
31 <summary>Gets the drive type, such as CD-ROM, removable, network, or fixed.</summary>
32 <returns>One of the enumeration values that specifies a drive type.</returns>
34 <member name="M:System.IO.DriveInfo.GetDrives">
35 <summary>Retrieves the drive names of all logical drives on a computer.</summary>
36 <returns>An array of type <see cref="System.IO.DriveInfo"></see> that represents the logical drives on a computer.</returns>
37 <exception cref="T:System.IO.IOException">An I/O error occurred (for example, a disk error or a drive was not ready).</exception>
38 <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission.</exception>
40 <member name="P:System.IO.DriveInfo.IsReady">
41 <summary>Gets a value that indicates whether a drive is ready.</summary>
42 <returns>true if the drive is ready; false if the drive is not ready.</returns>
44 <member name="P:System.IO.DriveInfo.Name">
45 <summary>Gets the name of a drive, such as C:\.</summary>
46 <returns>The name of the drive.</returns>
48 <member name="P:System.IO.DriveInfo.RootDirectory">
49 <summary>Gets the root directory of a drive.</summary>
50 <returns>An object that contains the root directory of the drive.</returns>
52 <member name="M:System.IO.DriveInfo.ToString">
53 <summary>Returns a drive name as a string.</summary>
54 <returns>The name of the drive.</returns>
56 <member name="P:System.IO.DriveInfo.TotalFreeSpace">
57 <summary>Gets the total amount of free space available on a drive, in bytes.</summary>
58 <returns>The total free space available on a drive, in bytes.</returns>
59 <exception cref="T:System.UnauthorizedAccessException">Access to the drive information is denied.</exception>
60 <exception cref="T:System.IO.DriveNotFoundException">The drive is not mapped or does not exist.</exception>
61 <exception cref="T:System.IO.IOException">An I/O error occurred (for example, a disk error or a drive was not ready).</exception>
63 <member name="P:System.IO.DriveInfo.TotalSize">
64 <summary>Gets the total size of storage space on a drive, in bytes.</summary>
65 <returns>The total size of the drive, in bytes.</returns>
66 <exception cref="T:System.UnauthorizedAccessException">Access to the drive information is denied.</exception>
67 <exception cref="T:System.IO.DriveNotFoundException">The drive is not mapped or does not exist.</exception>
68 <exception cref="T:System.IO.IOException">An I/O error occurred (for example, a disk error or a drive was not ready).</exception>
70 <member name="P:System.IO.DriveInfo.VolumeLabel">
71 <summary>Gets or sets the volume label of a drive.</summary>
72 <returns>The volume label.</returns>
73 <exception cref="T:System.IO.IOException">An I/O error occurred (for example, a disk error or a drive was not ready).</exception>
74 <exception cref="T:System.IO.DriveNotFoundException">The drive is not mapped or does not exist.</exception>
75 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
76 <exception cref="T:System.UnauthorizedAccessException">The volume label is being set on a network or CD-ROM drive.
78 Access to the drive information is denied.</exception>
80 <member name="M:System.IO.DriveInfo.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
81 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object with the data needed to serialize the target object.</summary>
82 <param name="info">The object to populate with data.</param>
83 <param name="context">The destination (see <see cref="T:System.Runtime.Serialization.StreamingContext"></see>) for this serialization.</param>
85 <member name="T:System.IO.DriveNotFoundException">
86 <summary>The exception that is thrown when trying to access a drive or share that is not available.</summary>
88 <member name="M:System.IO.DriveNotFoundException.#ctor">
89 <summary>Initializes a new instance of the <see cref="T:System.IO.DriveNotFoundException"></see> class with its message string set to a system-supplied message and its HRESULT set to COR_E_DIRECTORYNOTFOUND.</summary>
91 <member name="M:System.IO.DriveNotFoundException.#ctor(System.String)">
92 <summary>Initializes a new instance of the <see cref="T:System.IO.DriveNotFoundException"></see> class with the specified message string and the HRESULT set to COR_E_DIRECTORYNOTFOUND.</summary>
93 <param name="message">A <see cref="T:System.String"></see> object that describes the error. The caller of this constructor is required to ensure that this string has been localized for the current system culture.</param>
95 <member name="M:System.IO.DriveNotFoundException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
96 <summary>Initializes a new instance of the <see cref="T:System.IO.DriveNotFoundException"></see> class with the specified serialization and context information.</summary>
97 <param name="info">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object that contains the serialized object data about the exception being thrown.</param>
98 <param name="context">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> object that contains contextual information about the source or destination of the exception being thrown.</param>
100 <member name="M:System.IO.DriveNotFoundException.#ctor(System.String,System.Exception)">
101 <summary>Initializes a new instance of the <see cref="T:System.IO.DriveNotFoundException"></see> class with the specified error message and a reference to the inner exception that is the cause of this exception.</summary>
102 <param name="message">The error message that explains the reason for the exception.</param>
103 <param name="innerException">The exception that is the cause of the current exception. If the innerException parameter is not null, the current exception is raised in a catch block that handles the inner exception.</param>
105 <member name="T:System.IO.DriveType">
106 <summary>Defines constants for drive types, including CDRom, Fixed, Network, NoRootDirectory, Ram, Removable, and Unknown.</summary>
108 <member name="F:System.IO.DriveType.CDRom">
109 <summary>The drive is an optical disc device, such as a CD or DVD-ROM.</summary>
112 <member name="F:System.IO.DriveType.Fixed">
113 <summary>The drive is a fixed disk.</summary>
116 <member name="F:System.IO.DriveType.Network">
117 <summary>The drive is a network drive.</summary>
120 <member name="F:System.IO.DriveType.NoRootDirectory">
121 <summary>The drive does not have a root directory.</summary>
124 <member name="F:System.IO.DriveType.Ram">
125 <summary>The drive is a RAM disk.</summary>
128 <member name="F:System.IO.DriveType.Removable">
129 <summary>The drive is a removable storage device, such as a floppy disk drive or a USB flash drive.</summary>
132 <member name="F:System.IO.DriveType.Unknown">
133 <summary>The type of drive is unknown.</summary>