SPItemEventReceiver.ItemAdding method

Handles the synchronous event that occurs before an item is added.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

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

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.

See also

Reference

SPItemEventReceiver class

SPItemEventReceiver members

Microsoft.SharePoint namespace