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
)
參數
strNewUrl
Type: System.String目的 URL。
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。 |