SPFile.CopyTo - Méthode (String)

Article
05/12/2015

Copie le fichier dans l'URL de destination, mais ne remplace pas un fichier existant du même nom.

Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Sub CopyTo ( _
    strNewUrl As String _
)
'Utilisation
Dim instance As SPFile
Dim strNewUrl As String

instance.CopyTo(strNewUrl)

public void CopyTo(
    string strNewUrl
)

Paramètres

strNewUrl
Type : System.String

L'URL de destination.

Exceptions

Exception	Condition
SPException	Une erreur s'est produite lors de la copie du fichier.

Remarques

La méthode CopyTo copie les fichiers vers un autre emplacement au sein du même site. Pour copier des fichiers vers un emplacement sur un autre site, utilisez une des méthodes de la classe SPFileCollectionAdd .

Cette méthode renvoie une erreur si un fichier du même nom existe déjà sur le nouvel emplacement. Pour copier un fichier et d'écraser un fichier existant, appelez CopyTo(String, Boolean) avec strNewUrl et true.

Exemples

L'exemple de code suivant copie les fichiers à partir d'une bibliothèque de documents dans un autre si les fichiers sont archivés dans la bibliothèque d'origine avec le commentaire « Complete ».

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

Notes

Certains objets implémentent l'interface IDisposable , et vous devez éviter de conserver ces objets dans la mémoire après que qu'ils ne sont plus nécessaires. Pour plus d'informations sur les bonnes pratiques de codage, consultez Disposing Objects.

Voir aussi

Référence

SPFile classe

SPFile - Membres

CopyTo - Surcharge

Microsoft.SharePoint - Espace de noms

Partager via