Partager via


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

Déplace le fichier vers 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 MoveTo ( _
    newUrl As String, _
    bOverWrite As Boolean _
)
'Utilisation
Dim instance As SPFile
Dim newUrl As String
Dim bOverWrite As Boolean

instance.MoveTo(newUrl, bOverWrite)
public void MoveTo(
    string newUrl,
    bool bOverWrite
)

Paramètres

  • newUrl
    Type : System.String

    La nouvelle URL de destination pour le 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

Le paramètre bOverWrite est false et un fichier portant le même nom existe à l'URL de destination spécifié

- ou -

Une erreur s'est produite lors du déplacement du fichier.

Remarques

La méthode MoveTo est utilisée pour déplacer des fichiers vers un autre emplacement au sein du même site.

Exemples

L'exemple de code suivant déplace tous les fichiers par un auteur spécifié à partir d'un dossier vers un autre dossier. La boucle de For dans la décrémente d'exemple (intIndex--) au lieu des incréments (intIndex++), dans la mesure où les fichiers sont déplacés dans le dossier et le nombre de fichiers diminue avec chaque boucle.

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

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

MoveTo - Surcharge

Microsoft.SharePoint - Espace de noms