How To Move or Rename a File using MSBuild

Date Published: 07 April 2010

How To Move or Rename a File using MSBuild

MSBuild is a very powerful tool, and it’s relatively easy to get started using it. You can run a “hello world” example of MSBuild in no time, and it’s easy to build up the files incrementally as your needs (and knowledge of the tool) increase. Here’s a handy list of the tasks that are built into MSBuild.

Move File Task or Rename File Task

One thing that is missing from the built-in list of tasks is a file rename (or move) task. Fortunately, this is pretty easy to accomplish using a combination of the Copy and Delete tasks. Here’s a real-world example that renames a file from _web.config to web.config as part of a deployment script written in msbuild:

<Copy SourceFiles="precompiledwebLakeQuincyCom_configproduction_web.config" DestinationFiles="precompiledwebLakeQuincyCom_configproductionweb.config"> <Copy>

This is part of a larger build script that’s using the task to generate the site and ensure there are no build errors in the .aspx files of the site. The file paths in this care are relative to my build.proj file, but you could also specify absolute paths if you preferred.

There’s also a library of tasks you can install separately that includes a target, which you can find here:

I haven’t used this library in a number of years so I can’t say for certain how well it’s kept up. There are a bunch of potentially useful tasks in it, though, so if you need something more than simple file moving it might be worth investigating. For my needs of the day, Copy/Delete did the trick.

Steve Smith

About Ardalis

Software Engineer

Steve is an experienced software architect and trainer, focusing currently on ASP.NET Core and Domain-Driven Design.


Copyright © 2020