This topic has not yet been rated - Rate this topic

SPFile.MoveTo Method (String)

SharePoint 2010

Windows SharePoint Services 3

Moves the file to the destination URL but does not overwrite an existing file of the same name.

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

Syntax

Copy

public void MoveTo(
	string newUrl
)

Parameters

newUrl: Type: System.String
A string that specifies the destination URL.

Exceptions

Exception	Condition
SPException	A file of that name already exists at the specified location. -or- An error occurred when moving the file.

Exception

Condition

SPException

A file of that name already exists at the specified location.

-or-

An error occurred when moving the file.

Remarks

The MoveTo method moves files to another location within the same site.

Examples

The following code example moves files older than a specified date from one folder to another folder.

Copy

SPSite oSiteCollection = SPContext.Current.Site;
SPWeb oWebsite = oSiteCollection.AllWebs["Site_Name/Subsite_Name"];
SPFileCollection collFiles = oWebsite.GetFolder("Source_Folder").Files;
for (int intIndex=collFiles.Count-1; intIndex>-1; intIndex--)
{
    if (collFiles[intIndex].TimeCreated < 
        Convert.ToDateTime("12/01/2007 12:00:00 AM"))
    {
        collFiles[intIndex].MoveTo("Destination_Folder/" + collFiles[intIndex].Name);
    }
}
oWebsite.Dispose();

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.

Reference

SPFile Class

SPFile Members

MoveTo Overload

Microsoft.SharePoint Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ