SPFile.CopyTo-Methode (String)

Artikel
05/06/2015

Überschreibt eine vorhandene Datei mit demselben Namen, jedoch kopiert die Datei in den Ziel-URL.

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

Syntax

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

instance.CopyTo(strNewUrl)

public void CopyTo(
    string strNewUrl
)

Parameter

strNewUrl
Typ: System.String

Die Ziel-URL.

Ausnahmen

Ausnahme	Bedingung
SPException	Fehler beim Kopieren der Datei.

Hinweise

Die CopyTo -Methode kopiert Dateien an einen anderen Ort innerhalb desselben Standorts. Um Dateien an einen Speicherort auf einer anderen Website kopieren möchten, verwenden Sie eine der Add -Methoden der SPFileCollection -Klasse.

Diese Methode gibt einen Fehler zurück, wenn am neuen Speicherort bereits eine Datei mit demselben Namen vorhanden ist. Um eine Datei zu kopieren und eine vorhandene Datei überschreiben, rufen Sie CopyTo(String, Boolean) mit strNewUrl und true.

Beispiele

Im folgenden Codebeispiel wird kopiert Dateien aus einer Dokumentbibliothek in einen anderen, wenn die Dateien in der ursprünglichen Bibliothek mit dem Kommentar "Complete" eingecheckt werden.

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

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

Freigeben über