Sorting the Visual Studio "Add New Item" Dialog with PowerShell

The items in the "Add New Item" dialog box of Visual Studio appear in an arbitrary order. After a bit of sleuthing, I put together a brute force Powershell script to sort my items alphabetically. Now "Code File" appears near "Class", and I can always find "XML File" near the bottom of the dialog.

sorted items in vs2005

SortOrder, and my sanity, is restored.

What follows is the script. Download sort-vsItems.ps1. Let me caveat this script by saying it has only been tested on two machines. If you have any problems, do let me know.

# sort-vsItems
# scott@OdeToCode.com
# Modified by AlexanderGross at gmx dot de
#
# Use at your own risk!
# Script will make a backup of each template just in case.

# vjslib for .zip support.
[System.Reflection.Assembly]::Load("vjslib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") | out-null

# Get list of VS installed templates.
$installDir = [System.IO.Path]::Combine((gp HKLM:Software\Microsoft\VisualStudio\8.0).InstallDir, "ItemTemplates")
$templateFiles = gci -recurse $installDir | ? {$_.extension -eq ".zip"}

# Append list of custom templates.
$installDir = [System.IO.Path]::Combine((gp "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders").Personal, "Visual Studio 2005\Templates\ItemTemplates")
$templateFiles += gci -recurse $installDir | ? {$_.extension -eq ".zip"}

# Sort all templates by filename.
$templateFiles = $templateFiles | sort name

$i = 1
$count = 0
$tmpDir = new-item ([System.IO.Path]::Combine([System.IO.Path]::GetTempPath(), [System.IO.Path]::GetRandomFileName())) -type directory
$buffer = new-object System.SByte[] (8192)

# Iterate through all template files.
foreach($templateFile in $templateFiles)
{
write-host "Processing" $templateFile.FullName

# Extract all files (no methods available to modify zip in place).
$zip = new-object java.util.zip.ZipFile($templateFile.FullName)
$entries = $zip.entries()
while($entries.hasMoreElements())
{
$zipEntry = $entries.nextElement()

# Ensure output directory exists.
$filename = [System.IO.Path]::Combine($tmpDir.FullName, $zipEntry.getName())

# $zipEntry.isDirectory() does not work for Microsoft zips (e.g. Web\CSharp\WinFxServiceItemTemplate.zip).
$directory = [System.IO.Path]::GetDirectoryName($filename)
if ([System.IO.Directory]::Exists($directory) -ne $true)
{
mkdir $directory | out-null

# In case the zip tells us it's a directory entry, skip the entry to prevent exceptions.
if ($zipEntry.isDirectory())
{
continue
}
}

$in = $zip.getInputStream($zipEntry)
$out = new-object java.io.FileOutputStream($filename)

while(($count = $in.read($buffer, 0, $buffer.Count)) -gt 0)
{
$out.write($buffer, 0, $count)
}

$out.Close()
$in.Close()
}
$zip.Close()

# Tweak the sort order element.
$vst = gci -recurse $tmpDir | ? {$_.extension -eq ".vstemplate"}
if ($vst -eq $null)
{
# The zip file does not contain a vstemplate.

# Clean temporary directory for the next template file.
del $tmpDir\* -force -recurse
continue
}

$xmlDoc = new-object System.Xml.XmlDocument
$xmlDoc.Load($vst.FullName)
if ($xmlDoc.VSTemplate.TemplateData.SortOrder -ne $null)
{
# Sort by zip name. Sort order must be a multiple of 10.
$xmlDoc.VSTemplate.TemplateData.SortOrder = ($i++ * 10).ToString()

# Sort by item name in Visual Studio.
# Uncomment this line if you want to let Visual Studio sort by item name.
# $xmlDoc.VSTemplate.TemplateData.SortOrder = "10"

$xmlDoc.Save($vst.FullName)
}

# Backup existing zip file.
$backupName = $templateFile.FullName + ".bak"
if(test-path $backupName)
{
# Remove previous backups.
remove-item $backupName
}
move-item $templateFile.FullName $backupName

# Zip up modified version.
$zip = new-object java.util.zip.ZipOutputStream(new-object java.io.FileOutputStream($templateFile.FullName))
$files = gci -recurse $tmpDir
foreach($file in $files)
{
if ($file.Attributes -contains "Directory")
{
# Subfolders are created automatically with files residing in subfolders.
continue
}

# Create a file entry.
# Replacing the last backslash from $tmpDir.FullName is crucial, the zips would work with any other
# zip editor but Visual Studio doesn't like files with a leading backslash (though one doesn't see
# it in WinZip).
$zipEntry = new-object java.util.zip.ZipEntry($file.FullName.Replace($tmpDir.FullName + "\", ""))
$zip.putNextEntry($zipEntry)
$in = new-object java.io.FileInputStream($file.FullName)
while(($count = $in.read($buffer, 0, $buffer.Count)) -gt 0)
{
$zip.write($buffer, 0, $count)
}
$in.close()
$zip.closeEntry()

}
$zip.close()

# Clean temporary directory for the next template file.
del $tmpDir\* -force -recurse
}

del $tmpDir -force -recurse

write-host "Running Visual Studio to refresh templates"
$vstudio = (gp HKLM:Software\Microsoft\VisualStudio\8.0).InstallDir
& $vstudio\devenv /setup

Powershell is beauty!

Print | posted @ Saturday, February 10, 2007 5:24 AM

Comments on this entry:

Gravatar # re: Sorting the Visual Studio "Add New Item" Dialog with PowerShell
by Shaka at 2/10/2007 8:35 AM

you are the man
  
Gravatar # re: Sorting the Visual Studio "Add New Item" Dialog with PowerShell
by scott at 2/10/2007 4:40 PM

Hmm, thanks to Jason I remembered the SortOrder is supposed to be a multiple of 10. My script doesn't do that. Since this seems to be working for me, I'm going to leave the script "as is" for now.

Again - no guarantees I have not broken anything....
  
Gravatar # re: Sorting the Visual Studio "Add New Item" Dialog with PowerShell
by Jason Haley at 2/10/2007 4:56 PM

Scott, thanks for putting this into a script. There are still a few items out of our (according to their label in the dialog - like Window Form - due to using their file name as the order).

I looked at this awhile ago and have the listing of new items and new web items that I had on my machine at the time - along with their original sort order and file names at (jasonhaley.com/blog/archive/2005/12/11/129208.aspx
and jasonhaley.com/blog/archive/2005/12/18/129262.aspx)

You might be able to just rename those files before your order tweaking or special case the few that have file names not corresponding to their english label in the dialog.

I kept meaning to create a simple ui for this reordering but just never got around to it.
  
Gravatar # re: Sorting the Visual Studio "Add New Item" Dialog with PowerShell
by Brian Schmitt at 2/10/2007 5:15 PM

Not trying to subtract from what you did, but There is a file over here that does the same thing: http://www.bartholomew.id.au/(X(1)S(ahm5wp55zuwoaaqwd2fply55))/Default.aspx?Page=FixVsItemSortOrder&AspxAutoDetectCookieSupport=1
  
Gravatar # re: Sorting the Visual Studio "Add New Item" Dialog with PowerShell
by scott at 2/10/2007 10:00 PM

Brian:

Yeah, my Google powers didn't turn that up till after the fact. It looks like that project uses the SharpZipLib, which is cool.

I hope the Orcas version of .NET includes some serious support for archive files. This would have been much easier.
  
Gravatar # re: Sorting the Visual Studio "Add New Item" Dialog with PowerShell
by Aaron Prenot at 2/12/2007 10:47 PM

I did run into an issue running the script on my machine. Here is the error message (and some lines for context)

Processing C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\VisualBasic\WinFxServiceItemTemplate.zip

Processing C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\Web\VisualBasic\WinFxServiceItemTemplate
.zip
New-Object : Exception calling ".ctor" with "1" argument(s): "Could not find a part of the path 'C:\Documents and Setti
ngs\prenota\Desktop\j1pjv5ar.nbh\App_Code\service.vb'."
At C:\Documents and Settings\prenota\Desktop\sort-vsitems.ps1:40 char:24
+ $out = new-object <<<< java.io.FileOutputStream(
Exception calling "write" with "3" argument(s): "Cannot access a closed file."
At C:\Documents and Settings\prenota\Desktop\sort-vsitems.ps1:45 char:20
+ $out.write( <<<< $buffer, 0, $count)
Exception calling "write" with "3" argument(s): "Cannot access a closed file."
At C:\Documents and Settings\prenota\Desktop\sort-vsitems.ps1:45 char:20
+ $out.write( <<<< $buffer, 0, $count)
Processing C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\Web\CSharp\WinFxServiceItemTemplate.zip
New-Object : Exception calling ".ctor" with "1" argument(s): "Could not find a part of the path 'C:\Documents and Setti
ngs\prenota\Desktop\j1pjv5ar.nbh\App_Code\service.cs'."
At C:\Documents and Settings\prenota\Desktop\sort-vsitems.ps1:40 char:24
+ $out = new-object <<<< java.io.FileOutputStream(
Exception calling "write" with "3" argument(s): "Cannot access a closed file."
At C:\Documents and Settings\prenota\Desktop\sort-vsitems.ps1:45 char:20
+ $out.write( <<<< $buffer, 0, $count)
Exception calling "write" with "3" argument(s): "Cannot access a closed file."
At C:\Documents and Settings\prenota\Desktop\sort-vsitems.ps1:45 char:20
+ $out.write( <<<< $buffer, 0, $count)
Processing C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\CSharp\WinFxServiceItemTemplate.zip
Processing C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\VisualBasic\WinFXUserControl.zip
Processing C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\CSharp\WinFXUserControl.zip
Processing C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\VisualBasic\WinFXWindow.zip
Processing C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\CSharp\WinFXWindow.zip
Processing C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\JSharp\1033\WinScript.zip
Processing C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\CSharp\1033\WinScript.zip
  
Gravatar # re: Sorting the Visual Studio &amp;amp;quot;Add New Item&amp;amp;quot; Dialog with PowerShell
by scott at 2/13/2007 4:26 AM

Thanks for the report, Aaron. I will have to try the WCF item templates to see what happens.
  
Gravatar # re: Sorting the Visual Studio "Add New Item" Dialog with PowerShell
by satish at 1/12/2010 9:42 AM

thank for information is very nice

http://CSharpTalk.com

satish
  
Comments have been closed on this topic.
Scott Allen
Posts - 869
Comments - 4493
Stories - 14