File.MoveTo Method

Moves the file to the specified destination URL.

Namespace:  Microsoft.SharePoint.Client
Assemblies:   Microsoft.SharePoint.Client.Silverlight (in Microsoft.SharePoint.Client.Silverlight.dll);  Microsoft.SharePoint.Client (in Microsoft.SharePoint.Client.dll)

Syntax

'Declaration
<RemoteAttribute> _
Public Sub MoveTo ( _
    newUrl As String, _
    flags As MoveOperations _
)
'Usage
Dim instance As File
Dim newUrl As String
Dim flags As MoveOperations

instance.MoveTo(newUrl, flags)

[RemoteAttribute]
public void MoveTo(
    string newUrl,
    MoveOperations flags
)

Parameters

• newUrl
  Type: System.String

  Specifies the destination URL.

  It must not be a null reference (Nothing in Visual Basic). It must be a URL of relative or absolute form.

• flags
  Type: Microsoft.SharePoint.Client.MoveOperations

  Specifies the kind of move operation.

  It must not have flags other than MoveOperations.Overwrite or MoveOperations.AllowBrokenThickets set.

Exceptions

Exception	Condition
[Microsoft.SharePoint.SPDuplicateValuesFoundException]	List item could not be updated; duplicate values were found for one or more field(s) in the list. Error code: -2130575169.
[Microsoft.SharePoint.SPFileCheckOutException]	File is not checked out. Error code: -2147024738.
[Microsoft.SharePoint.SPFileCheckOutException]	File is already checked out to a user other than the current user. Error code: -2130575306.
[Microsoft.SharePoint.SPFileLockException]	File is not locked. Error code: -2147024729.
[Microsoft.SharePoint.SPFileLockException]	Operation timed out. Error code: -2147023436.
[Microsoft.SharePoint.SPFileLockException]	Shared lock on the file. Error code: -2147018894.
[Microsoft.SharePoint.SPFileLockException]	Exclusive lock on the file. Error code: -2147018887.
[Microsoft.SharePoint.SPInvalidLookupValuesException]	List item could not be updated; invalid lookup values were found for one or more field(s) in the list. Error code: -2130575159.
[System.ArgumentException]	The URL must refer to a location within the current Site Collection. Error code: -2147024809.
[System.UnauthorizedAccessException]	The current user has insufficient permissions. Error code: -2147024891.

See Also

Reference

File Class

File Members

Microsoft.SharePoint.Client Namespace