转：Event Handlers - Part 1: Everything you need to know about Microsoft Office SharePoint Server (MOSS) Event Handlers
2010-12-29 22:15
676 查看
Event Handlers - Part 1: Everything you need to know about Microsoft Office SharePoint Server (MOSS) Event Handlers.
This post is the first post of 3 posts.
Post 1: Everything you need to know about MOSS Event Handlers
Post 2: Developer Solution Starter Kit (Building and deploying event handlers to MOSS)
Post 3: Registering Event Handlers plus Site Settings - Manage Event Handlers
Overview
Today I want to talk in depth about a feature of Microsoft Office SharePoint Server 2007 (MOSS) that shows you just how extensible the SharePoint 2007 platform is! That feature is the ability to add custom event handlers to sites, lists, items and content types in your portal.
What is a custom event handler? A custom event handler is a .Net assembly that contains the additional business logic you need to run when the event occurs in SharePoint.
Why did I pick this feature? Well, no portal or business application ever really lives in isolation to your other Line of Business (LOB) applications, and shouldn't! Your portal solution needs to be dynamic, expect change and work seamlessly with the other systems in your environment. So, you may ask, what does this have to do with Event Handlers?
Well, event handlers allow you to add [SOMETHING] your business needs into the functionality of SharePoint. [SOMETHING] examples:
Retrieve information from a database such as filling in the remaining fields of a list based on a CustomerID (assuming you don't have an enterprise license for BDC)
Call a web service
Start a workflow
Perform list data validation
Convert document to PDF and store in alternative list.
Access data in another list.
The possibilities around writing custom event handlers to perform an action based on an event in SharePoint 2007 are endless!
Event Types
Here is a list of events that you can hook into:
Microsoft.SharePoint.SPWebEventReceiver : "Site Level"
Microsoft.SharePoint.SPListEventReceiver : "List Level"
Microsoft.SharePoint.SPItemEventReceiver : "List Item Level"
Asynchronous vs Synchronous Events: The "ing" and the "ed"
As you may have noticed above, there are two events raised for each type of event. The "...ing" event occurs before the action starts and the "...ed" occurs after the actions ends. "...ing" events occur synchronously while the "...ed" events occur asynchronously. What does this mean?
Synchronous events:
Occur before the event.
Block the flow of code execution until your event handler completes.
Provide you with the ability to cancel the events resulting in no after event (“...ed") being fired.
Asynchronous events:
Occur after the event.
Do not block the flow of code execution in SharePoint.
Combining Custom Event Handlers with Content Types = POWER!
Content Type is just what it sounds like: a metadata description of content that can include custom properties, a retention policy, and an associated set of workflows and business processes.
For example, a company may define a “Contract” Content Type that includes the required metadata to make it easy to find that contract later.
The “Contract” Content Type is now a metadata description definition that can be associated to lists such as Document Libraries in your SharePoint environment. Once added, you now have the ability to add and manage Contracts added to your portal.
This is where Event Handlers come in: You can attach custom event handlers to a Content Type! Once attached to the Content Type definition, it picks up the events wherever you use the content type. This is extremely powerful! Why? Well, you have the ability to target individual content types across the entire site collection. For example, wherever a “Contract” Content Type is used, you could store a link in another system for each Contract created in your system, no matter what document library the contract is stored in.
Best Practices
When building custom event handlers, keep the following points in mind:
1. Security:
The assembly you deploy to the Global Assembly Cache(GAC) is running with full trust. Watch out for the following:
Denial of Service attack: If a user uploads 10000 items to a list, what is the effect it will have to the systems your assembly uses.
SQL Injection attack: If a user attempts to insert SQL statements into a column of a list that your assembly uses to update a database, what mechanisms are you using to make sure the input is valid.
Cross Site scripting attack: What is the effect of adding script to a column that your assembly uses to update another area in SharePoint?
2. Performance:
Watch out for the following:
Load: What burden are you placing on your web front end servers to run the assembly each time an event occurs? Use performance counters to determine this.
Long Running Operations: Consider creating a custom SharePoint timer job. Kick off/ Schedule the Timer Job from the event rather than running all the logic inside the event. This will allow you to use the features of SharePoint to view whether the Timer Job ran successfully.
Sync vs Async Events: Synchronous events have to wait until your code completes before returning the page, whereas Asynchronous events show the page immediately.
3. Error Handling:
When using synchronous events and you decide to cancel an event, let the user know why the event was cancelled. For example, update a Task List with a message why it failed.
Log your errors so that you can determine what issue is occurring when your system is in production environment.
4. Connections: Cater for external systems being down when you are trying to connect to them. Don’t let your code / solution go belly up because you cannot connect to a database.
5. Bulk Operations:
The MSDN documentation mentions that event handlers will not fire when bulk operation is occurring. For example, when a new list is created, the FieldAdding event will not fire.
Limitations of Event Handler in SharePoint
Strangely there is no “SiteAdding”, “SiteAdded” event. However, if you really need this event you could create a “feature” to accomplish this. Features in SharePoint have a “FeatureActivated” event, where you could perform an action on creation of a site.
Summary
Custom Event handlers are a powerful tool in your arsenal as a SharePoint Architect/ Developer!
Filed under: WSS, MOSS 2007, Event Handlers, CodePlex, Starter Kit, How To
源文档 <http://blogs.msdn.com/brianwilson/archive/2007/03/05/part-1-event-handlers-everything-you-need-to-know-about-microsoft-office-sharepoint-portal-server-moss-event-handlers.aspx>
This post is the first post of 3 posts.
Post 1: Everything you need to know about MOSS Event Handlers
Post 2: Developer Solution Starter Kit (Building and deploying event handlers to MOSS)
Post 3: Registering Event Handlers plus Site Settings - Manage Event Handlers
Overview
Today I want to talk in depth about a feature of Microsoft Office SharePoint Server 2007 (MOSS) that shows you just how extensible the SharePoint 2007 platform is! That feature is the ability to add custom event handlers to sites, lists, items and content types in your portal.
What is a custom event handler? A custom event handler is a .Net assembly that contains the additional business logic you need to run when the event occurs in SharePoint.
Why did I pick this feature? Well, no portal or business application ever really lives in isolation to your other Line of Business (LOB) applications, and shouldn't! Your portal solution needs to be dynamic, expect change and work seamlessly with the other systems in your environment. So, you may ask, what does this have to do with Event Handlers?
Well, event handlers allow you to add [SOMETHING] your business needs into the functionality of SharePoint. [SOMETHING] examples:
Retrieve information from a database such as filling in the remaining fields of a list based on a CustomerID (assuming you don't have an enterprise license for BDC)
Call a web service
Start a workflow
Perform list data validation
Convert document to PDF and store in alternative list.
Access data in another list.
The possibilities around writing custom event handlers to perform an action based on an event in SharePoint 2007 are endless!
Event Types
Here is a list of events that you can hook into:
Microsoft.SharePoint.SPWebEventReceiver : "Site Level"
SiteDeleted | Occurs after a site collection has been deleted. |
| SiteDeleting | Occurs when a site collection is being deleted. |
| WebDeleted | Asynchronous Afterevent that occurs after an existing Web site is completely deleted. |
| WebDeleting | Synchronous before event that occurs before an existing Web site is completely deleted. |
| WebMoved | Asynchronous after event that occurs after an existing Web site has been moved. |
| WebMoving | Synchronous before event that occurs before an existing Web site has been renamed or moved to a different parent object. |
| FieldAdded | Occurs after a field link is added. |
| FieldAdding | Occurs when a field link is being added to a content type. |
| FieldDeleted | Occurs after a field has been removed from the list. |
| FieldDeleting | Occurs when a field is in the process of being removed from the list. |
| FieldUpdated | Occurs after a field link has been updated |
| FieldUpdating | Occurs when a field link is being updated |
| ItemAdded | Asynchronous After event that occurs after a new item has been added to its containing object. |
| ItemAdding | Synchronous before event that occurs when a new item is added to its containing object. |
| ItemAttachmentAdded | Asynchronous after event that occurs after a user adds an attachment to an item. |
| ItemAttachmentAdding | Synchronous before event that occurs when a user adds an attachment to an item. |
| ItemAttachmentDeleted | Asynchronous after event that occurs when after a user removes an attachment from an item. |
| ItemAttachmentDeleting | Synchronous before event that occurs when a user removes an attachment from an item. |
| ItemCheckedIn | Asynchronous after event that occurs after an item is checked in. |
| ItemCheckedOut | Asynchronous after event that occurs after an item is checked out. |
| ItemCheckingIn | Synchronous before event that occurs as a file is being checked in. |
| ItemCheckingOut | Synchronous before event that occurs after an item is checked out. |
| ItemDeleted | Asynchronous after event that occurs after an existing item is completely deleted. |
| ItemDeleting | Synchronous before event that occurs before an existing item is completely deleted. |
| ItemFileConverted | |
| ItemFileMoved | Occurs after a file is moved. |
| ItemFileMoving | Occurs when a file is being moved. |
| ItemUncheckedOut | Synchronous before event that occurs when an item is being unchecked out. |
| ItemUncheckingOut | Synchronous before event that occurs when an item is being unchecked out. |
| ItemUpdated | Asynchronous after event that occurs after an existing item is changed, for example, when the user changes data in one or more fields. |
| ItemUpdating | Synchronous before event that occurs when an existing item is changed, for example, when the user changes data in one or more fields. |
As you may have noticed above, there are two events raised for each type of event. The "...ing" event occurs before the action starts and the "...ed" occurs after the actions ends. "...ing" events occur synchronously while the "...ed" events occur asynchronously. What does this mean?
Synchronous events:
Occur before the event.
Block the flow of code execution until your event handler completes.
Provide you with the ability to cancel the events resulting in no after event (“...ed") being fired.
Asynchronous events:
Occur after the event.
Do not block the flow of code execution in SharePoint.
Combining Custom Event Handlers with Content Types = POWER!
Content Type is just what it sounds like: a metadata description of content that can include custom properties, a retention policy, and an associated set of workflows and business processes.
For example, a company may define a “Contract” Content Type that includes the required metadata to make it easy to find that contract later.
The “Contract” Content Type is now a metadata description definition that can be associated to lists such as Document Libraries in your SharePoint environment. Once added, you now have the ability to add and manage Contracts added to your portal.
This is where Event Handlers come in: You can attach custom event handlers to a Content Type! Once attached to the Content Type definition, it picks up the events wherever you use the content type. This is extremely powerful! Why? Well, you have the ability to target individual content types across the entire site collection. For example, wherever a “Contract” Content Type is used, you could store a link in another system for each Contract created in your system, no matter what document library the contract is stored in.
Best Practices
When building custom event handlers, keep the following points in mind:
1. Security:
The assembly you deploy to the Global Assembly Cache(GAC) is running with full trust. Watch out for the following:
Denial of Service attack: If a user uploads 10000 items to a list, what is the effect it will have to the systems your assembly uses.
SQL Injection attack: If a user attempts to insert SQL statements into a column of a list that your assembly uses to update a database, what mechanisms are you using to make sure the input is valid.
Cross Site scripting attack: What is the effect of adding script to a column that your assembly uses to update another area in SharePoint?
2. Performance:
Watch out for the following:
Load: What burden are you placing on your web front end servers to run the assembly each time an event occurs? Use performance counters to determine this.
Long Running Operations: Consider creating a custom SharePoint timer job. Kick off/ Schedule the Timer Job from the event rather than running all the logic inside the event. This will allow you to use the features of SharePoint to view whether the Timer Job ran successfully.
Sync vs Async Events: Synchronous events have to wait until your code completes before returning the page, whereas Asynchronous events show the page immediately.
3. Error Handling:
When using synchronous events and you decide to cancel an event, let the user know why the event was cancelled. For example, update a Task List with a message why it failed.
Log your errors so that you can determine what issue is occurring when your system is in production environment.
4. Connections: Cater for external systems being down when you are trying to connect to them. Don’t let your code / solution go belly up because you cannot connect to a database.
5. Bulk Operations:
The MSDN documentation mentions that event handlers will not fire when bulk operation is occurring. For example, when a new list is created, the FieldAdding event will not fire.
Limitations of Event Handler in SharePoint
Strangely there is no “SiteAdding”, “SiteAdded” event. However, if you really need this event you could create a “feature” to accomplish this. Features in SharePoint have a “FeatureActivated” event, where you could perform an action on creation of a site.
Summary
Custom Event handlers are a powerful tool in your arsenal as a SharePoint Architect/ Developer!
Filed under: WSS, MOSS 2007, Event Handlers, CodePlex, Starter Kit, How To
源文档 <http://blogs.msdn.com/brianwilson/archive/2007/03/05/part-1-event-handlers-everything-you-need-to-know-about-microsoft-office-sharepoint-portal-server-moss-event-handlers.aspx>
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- Something you need to know about Content Deployment in SharePoint
- Microsoft Office SharePoint Server 2007（MOSS 2007）简介
- FW: Everything you need to know about pointers in C
- 搭建基于MOSS的团队解决方案01——Microsoft Office SharePoint 2007 Server快速入门（Continued）
- [转][MS-MAVA]: Microsoft Office SharePoint Server (MOSS) Analytics View Access Protocol Specification
- What is LineageOS ? Everything you need to know about Lineage OS
- Configure Search On MOSS 2007 (Microsoft Office SharePoint Server)
- Everything you need to know about Authenticode Code Signing
- Everything You Need to Know About Rooting Your Android Phone
- The 9 Deep Learning Papers You Need To Know About (Understanding CNNs Part 3)
- The 9 Deep Learning Papers You Need To Know About (Understanding CNNs Part 3)
- MOSS（Microsoft Office Sharepoint Server）升级2013遇到的PDF权限问题及解决方案
- 100 Things You Need to Know about Microsoft Windows Vista
- What every SharePoint administrator needs to know about Alternate Access Mappings (Part 2 of 3)
- What you need to know about transimpedance amplifiers – part 1
- DB2 System Catalog Views: Everything You Need to Know About Your DB Objects
- What every SharePoint administrator needs to know about Alternate Access Mappings (Part 3 of 3)
- [翻译练习]密码学1小时入门 （Everything you need to know about cryptography in 1 hour）
- Everything you need to know about automatic reference counting (ARC)