SPFile.CopyTo method (String, Boolean)

發行項
05/05/2015

將檔案複製到目的 URL，並選擇性地覆寫相同名稱的現有檔案。

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

Syntax

'宣告
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
Type: System.String

新的檔案則目的地 URL。

bOverWrite
Type: System.Boolean

true覆寫現有檔案相同的名稱；否則false。

Exceptions

Exception	Condition
SPException	複製檔案時發生錯誤。

備註

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

如果bOverWrite設定為false ，新的位置已經存在相同名稱的檔案，這個方法會傳回錯誤。

Examples

下列程式碼範例會將所有檔案共享文件的文件庫中都複製到另一個資料夾相同的站台，覆寫相同名稱的任何檔案。

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。