SPEmailEventReceiver class
Provides a method for trapping the event when a list receives an email message.
Inheritance hierarchy
System.Object
Microsoft.SharePoint.SPEmailEventReceiver
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Class SPEmailEventReceiver
'Usage
Dim instance As SPEmailEventReceiver
public class SPEmailEventReceiver
Remarks
An incoming email event receiver must derive from this class and override the EmailReceived method.
Examples
The following code example shows how to use the SPEmailEventReceiver class in an event handler that responds to email messages received in a list by adding an item to the list.
This example requires using directives (Imports in Visual Basic) for the Microsoft.SharePoint and Microsoft.SharePoint.Utilities namespaces.
namespace Example_Namespace
{
public class Email_Handler: SPEmailEventReceiver
{
public override void EmailReceived(
SPList oList,
SPEmailMessage oMessage,
string strReceiverData)
{
SPListItem oListItem = oList.Items.Add();
oListItem["Title"] = oMessage.Headers["Subject"];
oListItem["Body"] = oMessage.HtmlBody;
oListItem.Update();
}
}
}
Namespace Example_Namespace
Public Class Email_Handler
Inherits SPEmailEventReceiver
Public Overrides Sub EmailReceived(ByVal oList As SPList, ByVal oMessage As SPEmailMessage, ByVal strReceiverData As String)
Dim oListItem As SPListItem = oList.Items.Add()
oListItem("Title") = oMessage.Headers("Subject")
oListItem("Body") = oMessage.HtmlBody
oListItem.Update()
End Sub
End Class
End Namespace
Note
Certain objects implement the IDisposable interface, and you must avoid retaining these objects in memory after they are no longer needed. For information about good coding practices, see Disposing Objects.
Thread safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.