Freigeben über


SPFile.CopyTo-Methode (String, Boolean)

Kopiert die Datei in den Ziel-URL und optional überschreibt eine vorhandene Datei mit demselben Namen.

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

Syntax

'Declaration
Public Sub CopyTo ( _
    strNewUrl As String, _
    bOverWrite As Boolean _
)
'Usage
Dim instance As SPFile
Dim strNewUrl As String
Dim bOverWrite As Boolean

instance.CopyTo(strNewUrl, bOverWrite)
public void CopyTo(
    string strNewUrl,
    bool bOverWrite
)

Parameter

  • bOverWrite
    Typ: System.Boolean

    true , um eine vorhandene Datei mit demselben Namen zu überschreiben; andernfalls false.

Ausnahmen

Ausnahme Bedingung
SPException

Fehler beim Kopieren der Datei.

Hinweise

Die CopyTo -Methode kopiert Dateien an einen anderen Speicherort auf der gleichen Website. Um Dateien an einem Speicherort an einen anderen Standort kopieren, verwenden Sie eine der Methoden der Klasse SPFileCollectionAdd .

Diese Methode gibt einen Fehler zurück, wenn bOverWrite auf false festgelegt ist und am neuen Speicherort bereits eine Datei mit demselben Namen vorhanden ist.

Beispiele

Das folgende Codebeispiel kopiert alle Dateien in der Dokumentbibliothek Freigegebene Dokumente in einen anderen Ordner auf der gleichen Website eine Datei mit demselben Namen zu überschreiben.

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);
    }
}

Hinweis

Bestimmte Objekte, die IDisposable -Schnittstelle implementieren, und müssen Sie vermeiden, diese Objekte im Arbeitsspeicher beibehalten, nachdem sie nicht mehr benötigt werden. Informationen zu bewährten Programmierpraktiken finden Sie unter Disposing Objects.

Siehe auch

Referenz

SPFile Klasse

SPFile-Member

CopyTo-Überladung

Microsoft.SharePoint-Namespace