SPFileVersionCollection.RestoreByID Method (Int32, String)
Restores the file version object that has the specified version ID to the collection with the specified lock ID.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: Yes
Available in SharePoint Online
Syntax
'Declaration
Public Sub RestoreByID ( _
vid As Integer, _
bypassSharedLockId As String _
)
'Usage
Dim instance As SPFileVersionCollection
Dim vid As Integer
Dim bypassSharedLockId As String
instance.RestoreByID(vid, bypassSharedLockId)
public void RestoreByID(
int vid,
string bypassSharedLockId
)
Parameters
vid
Type: System.Int32The version ID to restore.
bypassSharedLockId
Type: System.StringThe lock ID on the file.
Remarks
If versioning is enabled for the document library and the file is not checked out, the current file becomes the most recent version when a version is restored.
Using the RestoreByID method is the same as using a combination of the OpenBinary method of the SPFileVersion class and the SaveBinary method of the SPFile class, as in myVersion.File.SaveBinary(myVersions[5].OpenBinary). However, the RestoreByID method is more efficient.
If the file has a shared lock, the lock ID must be a match for the restore operation.