Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
.NET Framework 3.5
System.IO Namespace
 OnCreated Method

  Switch on low bandwidth view
This page is specific to
Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:
.NET Framework Class Library
FileSystemWatcher..::.OnCreated Method

Raises the Created event.

Namespace:  System.IO
Assembly:  System (in System.dll)
Visual Basic (Declaration)
Protected Sub OnCreated ( _
    e As FileSystemEventArgs _
)
Visual Basic (Usage)
Dim e As FileSystemEventArgs

Me.OnCreated(e)
C#
protected void OnCreated(
    FileSystemEventArgs e
)
Visual C++
protected:
void OnCreated(
    FileSystemEventArgs^ e
)
JScript
protected function OnCreated(
    e : FileSystemEventArgs
)

Parameters

e
Type: System.IO..::.FileSystemEventArgs
A FileSystemEventArgs that contains the event data.

OnCreated is called when a file or directory is created in the directory being monitored.

Some common occurrences, such as copying or moving a file or directory, do not correspond directly to an event, but these occurrences do cause events to be raised. When you copy a file or directory, the system raises a Created event in the directory to which the file was copied, if that directory is being watched. If the directory from which you copied was being watched by another instance of FileSystemWatcher, no event would be raised. For example, you create two instances of FileSystemWatcher. FileSystemWatcher1 is set to watch "C:\My Documents", and FileSystemWatcher2 is set to watch "C:\Your Documents". If you copy a file from "My Documents" and paste it into "Your Documents", a Created event will be raised in FileSystemWatcher2, but no event is raised for FileSystemWatcher1. Unlike copying, moving a file or directory raises two events. From the previous example, if you moved a file from "My Documents" to "Your Documents", a Created event would be raised in FileSystemWatcher2 and a Deleted event would be raised in FileSystemWatcher1.

The OnCreated event is raised as soon as a file is created. If a file is being copied or transferred into a watched directory, the OnCreated event will be raised immediately, followed by one or more OnChanged events.

Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

Notes to Inheritors:

When overriding OnCreated in a derived class, be sure to call the base class's OnCreated method.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker