SPFile.CopyTo - Méthode (String, Boolean)

Article
05/12/2015

Copie le fichier dans l'URL de destination et éventuellement remplace 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, _
    bOverWrite As Boolean _
)
'Utilisation
Dim instance As SPFile
Dim strNewUrl As String
Dim bOverWrite As Boolean

instance.CopyTo(strNewUrl, bOverWrite)

public void CopyTo(
    string strNewUrl,
    bool bOverWrite
)

Paramètres

strNewUrl
Type : System.String

L'URL de destination du nouveau fichier.

bOverWrite
Type : System.Boolean

true pour remplacer un fichier existant portant le même nom ; dans le cas contraire, false.

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 sur le même site. Pour copier des fichiers vers un emplacement dans un autre site, utilisez une des méthodes de la classe SPFileCollectionAdd .

Cette méthode renvoie une erreur si bOverWrite est défini sur false et un fichier du même nom existe déjà dans le nouvel emplacement.

Exemples

L'exemple de code suivant copie tous les fichiers dans la bibliothèque de documents Documents partagés dans un autre dossier sur le même site, remplaçant ainsi tout fichier portant le même nom.

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

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