SPFile.CopyTo 方法 (String)

项目
05/13/2015

将该文件复制到目标 URL，而不会覆盖具有相同名称的现有文件。

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

语法

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

instance.CopyTo(strNewUrl)

public void CopyTo(
    string strNewUrl
)

参数

strNewUrl
类型：System.String

目标 URL。

异常

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

备注

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

如果新位置已存在相同名称的文件，则此方法将返回一个错误。若要将一个文件复制并覆盖现有文件，调用CopyTo(String, Boolean)与strNewUrl和true。

示例

下面的代码示例将文件从复制一个文档库到另一个如果文件已签入注释"完成"与原始库。

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

For intIndex = 0 To files.Count - 1

    If files(intIndex).CheckInComment = "Complete" Then
        files(intIndex).CopyTo("Destination_DocLibrary/" & 
        files(intIndex).Name)
    End If

Next intIndex

SPSite oSiteCollection = SPContext.Current.Site;
using(SPWeb oWebsite = oSiteCollection.AllWebs["Site_Name"])
{
    SPFileCollection collFiles =   
        oWebsite.GetFolder("Source_DocLibrary").Files;

    for (int intIndex=0; i<collFiles.Count; intIndex++)
    {
        if (collFiles[intIndex].CheckInComment == "Complete")
        {
            colFiles[intIndex].CopyTo("Destination_DocLibrary/" + 
                colFiles[intIndex].Name);
        }
    }
}

备注

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