SPItemEventReceiver.ItemAdding Method
Handles the synchronous event that occurs before an item is added.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: Yes
Available in SharePoint Online
Syntax
'Declaration
Public Overridable Sub ItemAdding ( _
properties As SPItemEventProperties _
)
'Usage
Dim instance As SPItemEventReceiver
Dim properties As SPItemEventProperties
instance.ItemAdding(properties)
public virtual void ItemAdding(
SPItemEventProperties properties
)
Parameters
properties
Type: Microsoft.SharePoint.SPItemEventPropertiesThe properties of the event handler.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | properties is null . |
Remarks
This event occurs in the following situations:
Default data is populated from a template.
New items are created using the browser user interface.
New items are added using the object model or Web service.
Warning
When adding a new document to a document library, do not use the property setting Status=CancelNoError to cancel this event, since doing so redirects the user to the "File not found" error.