Expand Minimize

Do not call SPListItemVersion.Delete to delete multiple versions

When you delete multiple versions of a list item, use the DeleteByID() method; do not use the Delete() method. You will experience performance problems if you delete each SPListItemVersion object from an SPListItemVersionCollection object.

CheckId SPC050226
TypeName DoNotUseSPListItemVersionDelete
Severity CriticalWarning
Type Assembly

The recommended practice is to create an array that contains the ID properties of each version and then delete each version by using the SPListItemVersionCollection.DeleteByID method.

SPSite site = new SPSite("site url");
SPWeb web = site.OpenWeb();
SPList list = web.Lists["custom list name"];
SPListItem item = list.GetItemById(1);
SPFile file = web.GetFile(item.Url);
SPFileVersionCollection collection = file.Versions;
ArrayList idList = new ArrayList();
foreach (SPFileVersion ver in collection)
{
   idList.Add(ver.ID);
}
foreach (int verID in idList)
{
   try
   {
       collection.DeleteByID(verID);
   }
   catch (Exception ex)
   {
   }
}

To suppress this violation in managed code add the following attribute to the method which contains the instruction (available since SPCAF version v5.2). Learn more about SuppressMessage here.

// Important: Ensure to have #define CODE_ANALYSIS at the beginning of your .cs file
[SuppressMessage("SPCAF.Rules.BestPracticesGroup", "SPC050226:DoNotUseSPListItemVersionDelete", Justification = "Provide reason for suppression here")]
Disclaimer: The views and opinions expressed in this documentation and in SPCAF do not necessarily reflect the opinions and recommendations of Microsoft or any member of Microsoft. SPCAF and RENCORE are registered trademarks of Rencore. All other trademarks, service marks, collective marks, copyrights, registered names, and marks used or cited by this documentation are the property of their respective owners.