Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

SPWebEventReceiver.WebAdding Method

Synchronous Before event that occurs before a new subsite is created, but not when the root web site of a new site collection is created.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: Yes
Available in SharePoint Online
public virtual void WebAdding(
	SPWebEventProperties properties
)

Parameters

properties
Type: Microsoft.SharePoint.SPWebEventProperties
An SPWebEventProperties object that represents properties of the event handler.
ExceptionCondition
ArgumentNullException

properties is null .

The WebAdding(SPWebEventProperties) event occurs on the parent Web that is creating the new subweb, since the new subweb does not yet exist. For this reason, the URL-related properties may appear to be null, when in fact these values should be the URL of the parent Web when the parent Web is the root Web. More specifically, the ServerRelativeUrl property in the WebAdding event is the parent Web. On the other hand, this property on the WebProvisioned(SPWebEventProperties) event should be the newly created subweb.

Notes to Implementers

Since an event receiver has to be registered with the site collection before it's handlers can execute, the WebAdding and WebProvisioned handlers cannot run when a site collection and its root web site are created.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.