SPFile.CopyTo 方法 (String, Boolean)

项目
05/13/2015

将该文件复制到目标 URL，还可以覆盖具有相同名称的现有文件。

命名空间： Microsoft.SharePoint
程序集： Microsoft.SharePoint（位于 Microsoft.SharePoint.dll 中）

语法

声明
Public Sub CopyTo ( _
    strNewUrl As String, _
    bOverWrite As Boolean _
)
用法
Dim instance As SPFile
Dim strNewUrl As String
Dim bOverWrite As Boolean

instance.CopyTo(strNewUrl, bOverWrite)

public void CopyTo(
    string strNewUrl,
    bool bOverWrite
)

参数

strNewUrl
类型：System.String

新文件的目标 URL。

bOverWrite
类型：System.Boolean

true以覆盖现有文件的相同的名称；否则为false。

异常

异常	条件
SPException	复制文件时出错。

备注

CopyTo方法将文件复制到同一站点上的其他位置。若要将文件复制到另一个站点中的位置，使用SPFileCollection类的Add方法之一。

如果bOverWrite设置为false ，并且在新位置已存在相同名称的文件，则此方法将返回一个错误。

示例

下面的代码示例将所有的文件共享文档的文档库中复制到另一个文件夹相同的站点中，并覆盖具有相同名称的任何文件。

Dim site As SPSite = SPContext.Current.Site
Dim web As SPWeb = site.AllWebs("Site_Name/Subsite_Name")
Dim files As SPFileCollection = web.GetFolder("Shared Documents").Files
Dim intIndex As Integer

For intIndex = 0 To files.Count - 1

    files(intIndex).CopyTo("Destination_DocLib/" & 
        files(intIndex).Name, True)

Next intIndex

SPSite oSiteCollection = SPContext.Current.Site;
using(SPWeb oWebsite = oSite.AllWebs["Site_Name/Subsite_Name"])
{
    SPFileCollection collFiles = oWebsite.GetFolder("Shared 
        Documents").Files;

    for (int intIndex=0; intIndex<collFiles.Count; intIndex++)
    {
        collFiles[intIndex].CopyTo("Destination_DocLib/" + 
            collFiles[intIndex].Name, true);
    }
}

备注

某些对象实现IDisposable接口，并必须避免后不再需要保留这些对象在内存中。好的编码做法有关的信息，请参阅Disposing Objects。