.NET Project Rename Documentation
Thu, 09 Jul 2020 12:53 UTC by AppSoftware
.NET project renaming (within files, file names and directory names)
This console application is designed for finding and replacing text throughout .NET / Visual Studio projects, including inside project and data files, along with file and folder names, including solution files. By recursively renaming at the root of the project, you can avoid breaking links to project files and references to other projects in the solution.
You may want to do this if you are reusing an existing project as a base for a new project, but need to replace old names.
If you have a project with the name
Foo.Bar, which is used in namespaces, project names and file and folder names, and you want to change it to
My.New.Project, then run the program and enter the path, the find text (Foo.Bar) and the replace text (My.New.Project) when prompted.
You can also run from the command line by passing arguments instead:
- -p : Directory path
- -f : Find text
- -r : Replace text
Run with --help for help text.
All instances of the find text will be replaced, giving you a completely renamed project throught the file structure.
An attempt is made to avoid corrupting files managed by version control and visual studio (so
.vs directories are ignored). This list is not exhaustive though so ideally you will have the solution code in a directory other than where these files sit.
Running dotnet-script version
A version of this tool for running with dotnet-script is included in this repository at
Full documentation for dotnet-script is here: https://github.com/filipw/dotnet-script
To run using dotnet-script, you need to have the .NET Core 2.2 runtime installed.
If you do not have dotnet-script installed you can then install the tool using:
dotnet tool install -g dotnet-script
Navigate your terminal to the directory in this repository
> dotnet script app.csx
Since dotnet-script allows for running of scripts from remote locations, you can run the .csx script file without downloading this repository:
> dotnet script https://raw.githubusercontent.com/appsoftwareltd/dotnet-project-rename/master/src/dotnet-script/app.csx