SPFile.MoveTo method (String, Boolean)

發行項
05/05/2015

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

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

Syntax

'宣告
Public Sub MoveTo ( _
    newUrl As String, _
    bOverWrite As Boolean _
)
'用途
Dim instance As SPFile
Dim newUrl As String
Dim bOverWrite As Boolean

instance.MoveTo(newUrl, bOverWrite)

public void MoveTo(
    string newUrl,
    bool bOverWrite
)

參數

newUrl
Type: System.String

新的目的地 URL 的檔案。

bOverWrite
Type: System.Boolean

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

Exceptions

Exception	Condition
SPException	bOverWrite參數是false ，且有相同名稱的檔案存在於指定的目的地 URL -或- 移動檔案時發生錯誤。

SPException

bOverWrite參數是false ，且有相同名稱的檔案存在於指定的目的地 URL

-或-

移動檔案時發生錯誤。

備註

MoveTo方法用來將檔案移至同一個站台內的其他位置。

Examples

下列的程式碼範例會從一個資料夾指定作者的所有檔案都移到另一個資料夾。For中的迴圈範例就會減 1 (intIndex--) 而不是遞增 (intIndex++)，因為檔案正在移動資料夾和檔案數目就會減少，每個迴圈。

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

For i = files.Count - 1 To 0 Step -1

    If files(i).Author.LoginName = "User_Name" Then

        files(i).MoveTo("Destination_Folder/" & files(i).Name, True)

    End If

Next i

SPSite oSiteCollection = SPContext.Current.Site;
SPWeb oWebsite = oSiteCollection.AllWebs["Site_Name"];
SPFileCollection collFiles = oWebsite.GetFolder("Source_Folder").Files;
for (int intIndex=collFiles.Count-1; intIndex>-1; intIndex--)
{
    if (collFiles[intIndex].Author.LoginName == "User_Name")
    {
        collFiles[intIndex].MoveTo("Destination_Folder/" + files[intIndex].Name, true);
    }
}
oWebsite.Dispose();

注意事項
某些物件實作IDisposable介面，並且您必須避免之後不再需要保留這些物件在記憶體中。良好的程式碼撰寫方式的相關資訊，請參閱Disposing Objects。