SPUser.Update Method

Updates the database with changes made to the properties of the user object.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: Yes
Available in SharePoint Online

Syntax

'Declaration
<ClientCallableExceptionConstraintAttribute(FixedId := "8", ErrorType := GetType(SPDuplicateValuesFoundException),  _
    ErrorCode := , Condition := "Duplicate value was found.")> _
<ClientCallableExceptionConstraintAttribute(FixedId := "3", ErrorType := GetType(SPException),  _
    ErrorCode := , Condition := "Item does not exist.The page you selected contains an item that does not exist.  It may have been deleted by another user.")> _
<ClientCallableExceptionConstraintAttribute(FixedId := "4", ErrorType := GetType(UnauthorizedAccessException),  _
    Condition := "User does not have permissions to update this list item.")> _
<ClientCallableExceptionConstraintAttribute(FixedId := "5", ErrorType := GetType(SPListDataValidationException),  _
    ErrorCode := , Condition := "Validation for the current list item failed.")> _
<ClientCallableExceptionConstraintAttribute(FixedId := "6", ErrorType := GetType(SPListDataValidationException),  _
    ErrorCode := , Condition := "Validation for a field in the current list item failed.")> _
<ClientCallableExceptionConstraintAttribute(FixedId := "7", ErrorType := GetType(SPListDataValidationException),  _
    ErrorCode := , Condition := "Validation for the current list item and for one of its fields failed.")> _
<ClientCallableAttribute> _
Public Sub Update
'Usage
Dim instance As SPUser

instance.Update()

[ClientCallableExceptionConstraintAttribute(FixedId = "8", ErrorType = typeof(SPDuplicateValuesFoundException), 
    ErrorCode = , Condition = "Duplicate value was found.")]
[ClientCallableExceptionConstraintAttribute(FixedId = "3", ErrorType = typeof(SPException), 
    ErrorCode = , Condition = "Item does not exist.The page you selected contains an item that does not exist.  It may have been deleted by another user.")]
[ClientCallableExceptionConstraintAttribute(FixedId = "4", ErrorType = typeof(UnauthorizedAccessException), 
    Condition = "User does not have permissions to update this list item.")]
[ClientCallableExceptionConstraintAttribute(FixedId = "5", ErrorType = typeof(SPListDataValidationException), 
    ErrorCode = , Condition = "Validation for the current list item failed.")]
[ClientCallableExceptionConstraintAttribute(FixedId = "6", ErrorType = typeof(SPListDataValidationException), 
    ErrorCode = , Condition = "Validation for a field in the current list item failed.")]
[ClientCallableExceptionConstraintAttribute(FixedId = "7", ErrorType = typeof(SPListDataValidationException), 
    ErrorCode = , Condition = "Validation for the current list item and for one of its fields failed.")]
[ClientCallableAttribute]
public void Update()

Exceptions

Remarks

Call this method after setting the values for the properties of the user object to save the changes in the database.

Examples

The following code example modifies the e-mail address, display name, and notes for a specified user object.

Dim siteCollection As SPSite = SPControl.GetContextSite(Context)
Dim site As SPWeb = siteCollection.AllWebs("Site_Name")
Dim user As SPUser = site.AllUsers("User_Name")
user.Email = "E-mail_Address"
user.Name = "Display_Name"
user.Notes = "User_Notes"
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.Name = " Display_Name";
    oUser.Notes = " User_Notes";
    oUser.Update();
}

See Also

Reference

SPUser Class

SPUser Members

Microsoft.SharePoint Namespace