SPUser.Email Property
Gets or sets the e-mail address of the user. (Read-only in sandboxed solutions.)
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: Yes
Available in SharePoint Online
Syntax
'Declaration
<ClientCallableConstraintAttribute(Type := ClientCallableConstraintType.MaxLength, Value := )> _
<ClientCallableAttribute> _
<ClientCallableConstraintAttribute(Type := ClientCallableConstraintType.NotNull, Value := )> _
Public Property Email As String
Get
Set
'Usage
Dim instance As SPUser
Dim value As String
value = instance.Email
instance.Email = value
[ClientCallableConstraintAttribute(Type = ClientCallableConstraintType.MaxLength, Value = )]
[ClientCallableAttribute]
[ClientCallableConstraintAttribute(Type = ClientCallableConstraintType.NotNull, Value = )]
public string Email { get; set; }
Property Value
Type: System.String
A string that contains the e-mail address.
Remarks
To modify the e-mail address for a user by setting the value of the Email property, call the Update method to effect the changes in the database.
Examples
The following code example modifies the e-mail address for a specified user object.
Dim siteCollection As SPSite = SPControl.GetContextSite(Context)
Dim site As SPWeb = siteColl.AllWebs("Site_Name")
Dim user As SPUser = site.AllUsers("User_Name")
user.Email = "E-mail_Address"
user.Update()
SPSite oSiteCollection = SPContext.Current.Site;
using (SPWeb oWebsite = oSiteCollection.AllWebs["Website_Name"])
{
SPUser oUser = oWebsite.AllUsers["User_Name"];
oUser.Email = " E-mail_Address";
oUser.Update();
}
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.