共用方式為

SPFile.CopyTo method (String)

  • 發行項

將檔案複製到目的 URL，但不會覆寫相同名稱的現有檔案。

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'宣告
Public Sub CopyTo ( _
    strNewUrl As String _
)
'用途
Dim instance As SPFile
Dim strNewUrl As String

instance.CopyTo(strNewUrl)

public void CopyTo(
    string strNewUrl
)

參數

Exceptions

Exception Condition
SPException

複製檔案時發生錯誤。

備註

CopyTo方法會將檔案複製到同一個站台內的其他位置。若要將檔案複製到另一個站台上的位置，使用其中一個SPFileCollection類別的Add方法。

如果相同名稱的檔案已經存在於新的位置，這個方法會傳回錯誤。若要複製檔案並覆寫現有的檔案時，呼叫CopyTo(String, Boolean)strNewUrl與true。

Examples

下列程式碼範例將從一份文件庫，成另一個複製檔案，如果檔案已簽入註解 「 完成 」 的原始程式庫也一樣。

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。

請參閱

參照

SPFile class

SPFile members

CopyTo overload

Microsoft.SharePoint namespace