1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.IO.FileSystem.Watcher</name>
6 <member name="T:System.IO.RenamedEventHandler">
7 <summary>Represents the method that will handle the <see cref="E:System.IO.FileSystemWatcher.Renamed"></see> event of a <see cref="T:System.IO.FileSystemWatcher"></see> class.</summary>
8 <param name="sender">The source of the event.</param>
9 <param name="e">The <see cref="T:System.IO.RenamedEventArgs"></see> that contains the event data.</param>
11 <member name="T:System.IO.RenamedEventArgs">
12 <summary>Provides data for the <see cref="E:System.IO.FileSystemWatcher.Renamed"></see> event.</summary>
14 <member name="M:System.IO.RenamedEventArgs.#ctor(System.IO.WatcherChangeTypes,System.String,System.String,System.String)">
15 <summary>Initializes a new instance of the <see cref="T:System.IO.RenamedEventArgs"></see> class.</summary>
16 <param name="changeType">One of the <see cref="T:System.IO.WatcherChangeTypes"></see> values.</param>
17 <param name="directory">The name of the affected file or directory.</param>
18 <param name="name">The name of the affected file or directory.</param>
19 <param name="oldName">The old name of the affected file or directory.</param>
21 <member name="P:System.IO.RenamedEventArgs.OldFullPath">
22 <summary>Gets the previous fully qualified path of the affected file or directory.</summary>
23 <returns>The previous fully qualified path of the affected file or directory.</returns>
25 <member name="P:System.IO.RenamedEventArgs.OldName">
26 <summary>Gets the old name of the affected file or directory.</summary>
27 <returns>The previous name of the affected file or directory.</returns>
29 <member name="T:System.IO.NotifyFilters">
30 <summary>Specifies changes to watch for in a file or folder.</summary>
32 <member name="F:System.IO.NotifyFilters.Attributes">
33 <summary>The attributes of the file or folder.</summary>
36 <member name="F:System.IO.NotifyFilters.CreationTime">
37 <summary>The time the file or folder was created.</summary>
40 <member name="F:System.IO.NotifyFilters.DirectoryName">
41 <summary>The name of the directory.</summary>
44 <member name="F:System.IO.NotifyFilters.FileName">
45 <summary>The name of the file.</summary>
48 <member name="F:System.IO.NotifyFilters.LastAccess">
49 <summary>The date the file or folder was last opened.</summary>
52 <member name="F:System.IO.NotifyFilters.LastWrite">
53 <summary>The date the file or folder last had anything written to it.</summary>
56 <member name="F:System.IO.NotifyFilters.Security">
57 <summary>The security settings of the file or folder.</summary>
60 <member name="F:System.IO.NotifyFilters.Size">
61 <summary>The size of the file or folder.</summary>
64 <member name="T:System.IO.InternalBufferOverflowException">
65 <summary>The exception thrown when the internal buffer overflows.</summary>
67 <member name="M:System.IO.InternalBufferOverflowException.#ctor">
68 <summary>Initializes a new default instance of the <see cref="T:System.IO.InternalBufferOverflowException"></see> class.</summary>
70 <member name="M:System.IO.InternalBufferOverflowException.#ctor(System.String)">
71 <summary>Initializes a new instance of the <see cref="T:System.IO.InternalBufferOverflowException"></see> class with the error message to be displayed specified.</summary>
72 <param name="message">The message to be given for the exception.</param>
74 <member name="M:System.IO.InternalBufferOverflowException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
75 <summary>Initializes a new, empty instance of the <see cref="T:System.IO.InternalBufferOverflowException"></see> class that is serializable using the specified <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> objects.</summary>
76 <param name="info">The information required to serialize the T:System.IO.InternalBufferOverflowException object.</param>
77 <param name="context">The source and destination of the serialized stream associated with the T:System.IO.InternalBufferOverflowException object.</param>
79 <member name="M:System.IO.InternalBufferOverflowException.#ctor(System.String,System.Exception)">
80 <summary>Initializes a new instance of the <see cref="T:System.IO.InternalBufferOverflowException"></see> class with the message to be displayed and the generated inner exception specified.</summary>
81 <param name="message">The message to be given for the exception.</param>
82 <param name="inner">The inner exception.</param>
84 <member name="T:System.IO.FileSystemWatcher">
85 <summary>Listens to the file system change notifications and raises events when a directory, or file in a directory, changes.</summary>
87 <member name="M:System.IO.FileSystemWatcher.#ctor">
88 <summary>Initializes a new instance of the <see cref="T:System.IO.FileSystemWatcher"></see> class.</summary>
90 <member name="M:System.IO.FileSystemWatcher.#ctor(System.String)">
91 <summary>Initializes a new instance of the <see cref="T:System.IO.FileSystemWatcher"></see> class, given the specified directory to monitor.</summary>
92 <param name="path">The directory to monitor, in standard or Universal Naming Convention (UNC) notation.</param>
93 <exception cref="T:System.ArgumentNullException">The <paramref name="path">path</paramref> parameter is <see langword="null"></see>.</exception>
94 <exception cref="T:System.ArgumentException">The <paramref name="path">path</paramref> parameter is an empty string (&quot;&quot;).
96 The path specified through the <paramref name="path">path</paramref> parameter does not exist.</exception>
97 <exception cref="T:System.IO.PathTooLongException"><paramref name="path">path</paramref> is too long.</exception>
99 <member name="M:System.IO.FileSystemWatcher.#ctor(System.String,System.String)">
100 <summary>Initializes a new instance of the <see cref="T:System.IO.FileSystemWatcher"></see> class, given the specified directory and type of files to monitor.</summary>
101 <param name="path">The directory to monitor, in standard or Universal Naming Convention (UNC) notation.</param>
102 <param name="filter">The type of files to watch. For example, &quot;*.txt&quot; watches for changes to all text files.</param>
103 <exception cref="T:System.ArgumentNullException">The <paramref name="path">path</paramref> parameter is <see langword="null"></see>.
105 The <paramref name="filter">filter</paramref> parameter is <see langword="null"></see>.</exception>
106 <exception cref="T:System.ArgumentException">The <paramref name="path">path</paramref> parameter is an empty string (&quot;&quot;).
108 The path specified through the <paramref name="path">path</paramref> parameter does not exist.</exception>
109 <exception cref="T:System.IO.PathTooLongException"><paramref name="path">path</paramref> is too long.</exception>
111 <member name="M:System.IO.FileSystemWatcher.BeginInit">
112 <summary>Begins the initialization of a <see cref="T:System.IO.FileSystemWatcher"></see> used on a form or used by another component. The initialization occurs at run time.</summary>
114 <member name="E:System.IO.FileSystemWatcher.Changed">
115 <summary>Occurs when a file or directory in the specified <see cref="P:System.IO.FileSystemWatcher.Path"></see> is changed.</summary>
117 <member name="E:System.IO.FileSystemWatcher.Created">
118 <summary>Occurs when a file or directory in the specified <see cref="P:System.IO.FileSystemWatcher.Path"></see> is created.</summary>
120 <member name="E:System.IO.FileSystemWatcher.Deleted">
121 <summary>Occurs when a file or directory in the specified <see cref="P:System.IO.FileSystemWatcher.Path"></see> is deleted.</summary>
123 <member name="M:System.IO.FileSystemWatcher.Dispose">
126 <member name="M:System.IO.FileSystemWatcher.Dispose(System.Boolean)">
127 <summary>Releases the unmanaged resources used by the <see cref="T:System.IO.FileSystemWatcher"></see> and optionally releases the managed resources.</summary>
128 <param name="disposing"><see langword="true"></see> to release both managed and unmanaged resources; <see langword="false"></see> to release only unmanaged resources.</param>
130 <member name="P:System.IO.FileSystemWatcher.EnableRaisingEvents">
131 <summary>Gets or sets a value indicating whether the component is enabled.</summary>
132 <returns><see langword="true"></see> if the component is enabled; otherwise, <see langword="false"></see>. The default is <see langword="false"></see>. If you are using the component on a designer in Visual Studio 2005, the default is <see langword="true"></see>.</returns>
133 <exception cref="T:System.ObjectDisposedException">The <see cref="System.IO.FileSystemWatcher"></see> object has been disposed.</exception>
134 <exception cref="T:System.PlatformNotSupportedException">The current operating system is not Microsoft Windows NT or later.</exception>
135 <exception cref="T:System.IO.FileNotFoundException">The directory specified in <see cref="System.IO.FileSystemWatcher.Path"></see> could not be found.</exception>
136 <exception cref="T:System.ArgumentException"><see cref="System.IO.FileSystemWatcher.Path"></see> has not been set or is invalid.</exception>
138 <member name="M:System.IO.FileSystemWatcher.EndInit">
139 <summary>Ends the initialization of a <see cref="T:System.IO.FileSystemWatcher"></see> used on a form or used by another component. The initialization occurs at run time.</summary>
141 <member name="E:System.IO.FileSystemWatcher.Error">
142 <summary>Occurs when the instance of <see cref="T:System.IO.FileSystemWatcher"></see> is unable to continue monitoring changes or when the internal buffer overflows.</summary>
144 <member name="P:System.IO.FileSystemWatcher.Filter">
145 <summary>Gets or sets the filter string used to determine what files are monitored in a directory.</summary>
146 <returns>The filter string. The default is &quot;*.*&quot; (Watches all files.)</returns>
148 <member name="P:System.IO.FileSystemWatcher.IncludeSubdirectories">
149 <summary>Gets or sets a value indicating whether subdirectories within the specified path should be monitored.</summary>
150 <returns><see langword="true"></see> if you want to monitor subdirectories; otherwise, <see langword="false"></see>. The default is <see langword="false"></see>.</returns>
152 <member name="P:System.IO.FileSystemWatcher.InternalBufferSize">
153 <summary>Gets or sets the size (in bytes) of the internal buffer.</summary>
154 <returns>The internal buffer size in bytes. The default is 8192 (8 KB).</returns>
156 <member name="P:System.IO.FileSystemWatcher.NotifyFilter">
157 <summary>Gets or sets the type of changes to watch for.</summary>
158 <returns>One of the <see cref="T:System.IO.NotifyFilters"></see> values. The default is the bitwise OR combination of <see langword="LastWrite"></see>, <see langword="FileName"></see>, and <see langword="DirectoryName"></see>.</returns>
159 <exception cref="T:System.ArgumentException">The value is not a valid bitwise OR combination of the <see cref="System.IO.NotifyFilters"></see> values.</exception>
160 <exception cref="T:System.ComponentModel.InvalidEnumArgumentException">The value that is being set is not valid.</exception>
162 <member name="M:System.IO.FileSystemWatcher.OnChanged(System.IO.FileSystemEventArgs)">
163 <summary>Raises the <see cref="E:System.IO.FileSystemWatcher.Changed"></see> event.</summary>
164 <param name="e">A <see cref="T:System.IO.FileSystemEventArgs"></see> that contains the event data.</param>
166 <member name="M:System.IO.FileSystemWatcher.OnCreated(System.IO.FileSystemEventArgs)">
167 <summary>Raises the <see cref="E:System.IO.FileSystemWatcher.Created"></see> event.</summary>
168 <param name="e">A <see cref="T:System.IO.FileSystemEventArgs"></see> that contains the event data.</param>
170 <member name="M:System.IO.FileSystemWatcher.OnDeleted(System.IO.FileSystemEventArgs)">
171 <summary>Raises the <see cref="E:System.IO.FileSystemWatcher.Deleted"></see> event.</summary>
172 <param name="e">A <see cref="T:System.IO.FileSystemEventArgs"></see> that contains the event data.</param>
174 <member name="M:System.IO.FileSystemWatcher.OnError(System.IO.ErrorEventArgs)">
175 <summary>Raises the <see cref="E:System.IO.FileSystemWatcher.Error"></see> event.</summary>
176 <param name="e">An <see cref="T:System.IO.ErrorEventArgs"></see> that contains the event data.</param>
178 <member name="M:System.IO.FileSystemWatcher.OnRenamed(System.IO.RenamedEventArgs)">
179 <summary>Raises the <see cref="E:System.IO.FileSystemWatcher.Renamed"></see> event.</summary>
180 <param name="e">A <see cref="T:System.IO.RenamedEventArgs"></see> that contains the event data.</param>
182 <member name="P:System.IO.FileSystemWatcher.Path">
183 <summary>Gets or sets the path of the directory to watch.</summary>
184 <returns>The path to monitor. The default is an empty string (&quot;&quot;).</returns>
185 <exception cref="T:System.ArgumentException">The specified path does not exist or could not be found.
187 The specified path contains wildcard characters.
189 The specified path contains invalid path characters.</exception>
191 <member name="E:System.IO.FileSystemWatcher.Renamed">
192 <summary>Occurs when a file or directory in the specified <see cref="P:System.IO.FileSystemWatcher.Path"></see> is renamed.</summary>
194 <member name="P:System.IO.FileSystemWatcher.Site">
195 <summary>Gets or sets an <see cref="T:System.ComponentModel.ISite"></see> for the <see cref="T:System.IO.FileSystemWatcher"></see>.</summary>
196 <returns>An <see cref="T:System.ComponentModel.ISite"></see> for the <see cref="T:System.IO.FileSystemWatcher"></see>.</returns>
198 <member name="P:System.IO.FileSystemWatcher.SynchronizingObject">
199 <summary>Gets or sets the object used to marshal the event handler calls issued as a result of a directory change.</summary>
200 <returns>The <see cref="T:System.ComponentModel.ISynchronizeInvoke"></see> that represents the object used to marshal the event handler calls issued as a result of a directory change. The default is <see langword="null"></see>.</returns>
202 <member name="M:System.IO.FileSystemWatcher.WaitForChanged(System.IO.WatcherChangeTypes)">
203 <summary>A synchronous method that returns a structure that contains specific information on the change that occurred, given the type of change you want to monitor.</summary>
204 <param name="changeType">The <see cref="T:System.IO.WatcherChangeTypes"></see> to watch for.</param>
205 <returns>A <see cref="T:System.IO.WaitForChangedResult"></see> that contains specific information on the change that occurred.</returns>
207 <member name="M:System.IO.FileSystemWatcher.WaitForChanged(System.IO.WatcherChangeTypes,System.Int32)">
208 <summary>A synchronous method that returns a structure that contains specific information on the change that occurred, given the type of change you want to monitor and the time (in milliseconds) to wait before timing out.</summary>
209 <param name="changeType">The <see cref="T:System.IO.WatcherChangeTypes"></see> to watch for.</param>
210 <param name="timeout">The time (in milliseconds) to wait before timing out.</param>
211 <returns>A <see cref="T:System.IO.WaitForChangedResult"></see> that contains specific information on the change that occurred.</returns>
213 <member name="T:System.IO.FileSystemEventHandler">
214 <summary>Represents the method that will handle the <see cref="E:System.IO.FileSystemWatcher.Changed"></see>, <see cref="E:System.IO.FileSystemWatcher.Created"></see>, or <see cref="E:System.IO.FileSystemWatcher.Deleted"></see> event of a <see cref="T:System.IO.FileSystemWatcher"></see> class.</summary>
215 <param name="sender">The source of the event.</param>
216 <param name="e">The <see cref="T:System.IO.FileSystemEventArgs"></see> that contains the event data.</param>
218 <member name="T:System.IO.FileSystemEventArgs">
219 <summary>Provides data for the directory events: <see cref="E:System.IO.FileSystemWatcher.Changed"></see>, <see cref="E:System.IO.FileSystemWatcher.Created"></see>, <see cref="E:System.IO.FileSystemWatcher.Deleted"></see>.</summary>
221 <member name="M:System.IO.FileSystemEventArgs.#ctor(System.IO.WatcherChangeTypes,System.String,System.String)">
222 <summary>Initializes a new instance of the <see cref="T:System.IO.FileSystemEventArgs"></see> class.</summary>
223 <param name="changeType">One of the <see cref="T:System.IO.WatcherChangeTypes"></see> values, which represents the kind of change detected in the file system.</param>
224 <param name="directory">The root directory of the affected file or directory.</param>
225 <param name="name">The name of the affected file or directory.</param>
227 <member name="P:System.IO.FileSystemEventArgs.ChangeType">
228 <summary>Gets the type of directory event that occurred.</summary>
229 <returns>One of the <see cref="T:System.IO.WatcherChangeTypes"></see> values that represents the kind of change detected in the file system.</returns>
231 <member name="P:System.IO.FileSystemEventArgs.FullPath">
232 <summary>Gets the fully qualifed path of the affected file or directory.</summary>
233 <returns>The path of the affected file or directory.</returns>
235 <member name="P:System.IO.FileSystemEventArgs.Name">
236 <summary>Gets the name of the affected file or directory.</summary>
237 <returns>The name of the affected file or directory.</returns>
239 <member name="T:System.IO.ErrorEventHandler">
240 <summary>Represents the method that will handle the <see cref="E:System.IO.FileSystemWatcher.Error"></see> event of a <see cref="T:System.IO.FileSystemWatcher"></see> object.</summary>
241 <param name="sender">The source of the event.</param>
242 <param name="e">An <see cref="T:System.IO.ErrorEventArgs"></see> object that contains the event data.</param>
244 <member name="T:System.IO.ErrorEventArgs">
245 <summary>Provides data for the <see cref="E:System.IO.FileSystemWatcher.Error"></see> event.</summary>
247 <member name="M:System.IO.ErrorEventArgs.#ctor(System.Exception)">
248 <summary>Initializes a new instance of the <see cref="T:System.IO.ErrorEventArgs"></see> class.</summary>
249 <param name="exception">An <see cref="T:System.Exception"></see> that represents the error that occurred.</param>
251 <member name="M:System.IO.ErrorEventArgs.GetException">
252 <summary>Gets the <see cref="T:System.Exception"></see> that represents the error that occurred.</summary>
253 <returns>An <see cref="T:System.Exception"></see> that represents the error that occurred.</returns>
255 <member name="T:System.IO.WatcherChangeTypes">
256 <summary>Changes that might occur to a file or directory.</summary>
258 <member name="F:System.IO.WatcherChangeTypes.All">
259 <summary>The creation, deletion, change, or renaming of a file or folder.</summary>
262 <member name="F:System.IO.WatcherChangeTypes.Changed">
263 <summary>The change of a file or folder. The types of changes include: changes to size, attributes, security settings, last write, and last access time.</summary>
266 <member name="F:System.IO.WatcherChangeTypes.Created">
267 <summary>The creation of a file or folder.</summary>
270 <member name="F:System.IO.WatcherChangeTypes.Deleted">
271 <summary>The deletion of a file or folder.</summary>
274 <member name="F:System.IO.WatcherChangeTypes.Renamed">
275 <summary>The renaming of a file or folder.</summary>
278 <member name="T:System.IO.WaitForChangedResult">
279 <summary>Contains information on the change that occurred.</summary>
281 <member name="P:System.IO.WaitForChangedResult.ChangeType">
282 <summary>Gets or sets the type of change that occurred.</summary>
283 <returns>One of the <see cref="T:System.IO.WatcherChangeTypes"></see> values.</returns>
285 <member name="P:System.IO.WaitForChangedResult.Name">
286 <summary>Gets or sets the name of the file or directory that changed.</summary>
287 <returns>The name of the file or directory that changed.</returns>
289 <member name="P:System.IO.WaitForChangedResult.OldName">
290 <summary>Gets or sets the original name of the file or directory that was renamed.</summary>
291 <returns>The original name of the file or directory that was renamed.</returns>
293 <member name="P:System.IO.WaitForChangedResult.TimedOut">
294 <summary>Gets or sets a value indicating whether the wait operation timed out.</summary>
295 <returns><see langword="true"></see> if the <see cref="M:System.IO.FileSystemWatcher.WaitForChanged(System.IO.WatcherChangeTypes)"></see> method timed out; otherwise, <see langword="false"></see>.</returns>