Улучшение справочной системы Visual Studio 2010

Справочная система в новой Visual Studio 2010 с одной стороны сделала большой шаг вперед – новое, отлично проработанное API (MS Help 3 / Microsoft Help Viewer 1.0), с другой стороны - идущая в комплекте программа просмотра очень многих не устроила.

Microsoft утверждает, что просто не успела привести его к соответствующему виду:

A number of VS 2010 Beta 2 customers have asked why we did not deliver a Keyword Index as part of the new help system. We realize the importance of delivering a keyword index, but we were unable to deliver it in our first release. In this V1.0 release of help system, we first implemented an improved search capability in order to deliver a more familiar, consistent online and offline experience. We then implemented a keyword index feature based on our search catalog. Unfortunately, the results did not meet our quality bar and we determined that this feature would require more work than the Beta 2 timeline allowed. We are looking at implementing it for at future release.

К счастью, решение все же есть и не одно.

Первый вариант поставить расширение Keyword Index for Visual Studio 2010 Help Documentation , написанное Ryan Linton и позволяющее просматривать непосредственно в VS IDE.

 

Подробнее о том, как установить и что получится в результате можно посмотреть тут.

Второй вариант – воспользоваться MS Help 3 Viewer , разработанный Rob Chandler, который позволит работать со справкой в привычном для Visual Studio 2008 виде :

Справка по программе

Ссылки по теме:

Help is missing an index - Отзыв на Microsoft Connect.

The Helpware Group – подборка информации и утилит по новой справочной системе, раздел, посвященный новому формату 

Блог Rob Chandler (Helpware Blog)

Описание HelpViewerKeywordIndex VS 2010 Ext

MS Help 3 Viewer by The Helpware Group

Возможности расширения приложений .NET

Уже довольно давно не обновлял свой блог: навалилось много работы, домашние дела и вообще много всего. Постараюсь исправиться :)

Microsoft решила более-менее стандартизировать подход к расширению приложений за счет разнообразных плагинов:

Microsoft .NET Framework сильно облегчает встраивание в собственные приложения компонентов, созданных другими разработчиками. Однако это просто, только если известно, к каким компонентам выполняется привязка. Если в момент сборки такие компоненты не известны, что типично для надстроек, то все становится намного сложнее. При расширении своих приложений у разработчиков часто возникают вопросы. Например, надстройки следует хранить в базе данных или на диске? Следует ли в надстройке использовать известный интерфейс или запрашивать тип для активации? Каков наилучший способ использования AppDomain, AppDomainManager и AppDomainSetup?

Эти и другие вопросы решаются в двух выпусках внутреннего бюллетеня CLR за счет введения в библиотеку базовых классов нового пространства имен System.AddIn, которое будет доступно в следующем выпуске Visual Studio^® (с кодовым именем "Orcas").

Подробнее об этом можно узнать на русском языке, прочитав статью из февральского номера CLR Inside Out и ее продолжение Расширяемость приложений .NET, часть 2.

Этому же посвящен блог разработчиков: CLR Add-In Team Blog.

В блоге Jason He's WebLog рассматривается реализация данной модели для Paint.Net. Может быть интересен и блог одного из авторов: Jack Gudenkauf (JackG) WebLog.

Новые библиотеки доступны в январском CTP Visual Studio

Technorati tags: .NET, Visual Studio

Blogus tags: .NET, Visual Studio

Tweak'и для Visual Studio 2005 SP1

Выпущенный недавно Service Pack (SP) для Visual Studio требует для установки очень много времени и свободного дискового пространства. Однако, эту ситуацию можно улучшить.

Для установки создайте и выполните командный файл:

reg export HKLM\Software\Policies\Microsoft\Windows\Installer installer.reg reg add HKLM\Software\Policies\Microsoft\Windows\Installer /v MaxPatchCacheSize /t REG_DWORD /d 0 /f net stop msiserver start /wait VS80-KBnnnnnn-X86-mmm.exe reg delete HKLM\Software\Policies\Microsoft\Windows\Installer /v MaxPatchCacheSize /f reg import installer.reg net stop msiserver del /q installer.reg 2>nul

Здесь VS80-KBnnnnnn-X86-mmm.exe - имя файла с Service Pack'ом.

Подробнее можно почитать в блоге у автора метода: Save Time and Space for VS 2005 SP1 by Disabling the Patch Cache

Там же доступна информация о встраивании SP в инсталляционный пакет: Slipstreaming Visual Studio 2005 Service Pack 1

Technorati tags: Visual Studio

Blogus tags : Visual Studio

Professional C#/VB .NET Coding Guidelines

Компания SubMain выложила в свободный доступ книгу "Professional C#/VB .NET Coding Guidelines", посвященную вопросам соглашения имен, проверенным практикам кодирования и паттернам.

Книга содержит информацию по следующим темам:

• Naming Guidelines
• Class Member Usage Guidelines
• Guidelines for Exposing Functionality to COM
• Error Raising & Handling Guidelines
• Array Usage Guidelines
• Operator Overloading Usage Guidelines
• Guidelines for Casting Types
• Common Design Patterns
• Callback Function Usage
• Time-Out Usage
• Security in Class Libraries
• Threading Design Guidelines
• Formatting Standards
• Commenting Code
• Code Reviews
• Additional Notes for VB .NET Developers

Прямая ссылка на книгу. Перед скачиванием необходимо будет указать произвольный e-mail.

Там же на сайте обнаружил удобный бесплатный плагин для Visual Studio: SmartOutline for VS2005, облегчающий работу с регионами.

• Easy way to create, edit and remove custom regions - even those that are not possible with the VS built-in tools
• Works in any Visual Studio code editor, including custom editors
• Works in conjunction with the auto outlining feature of the code editors such as those for VB.NET, C# etc
• Persists/saves state (region name, collapsed/expanded) of regions between Visual Studio sessions

Technorati tags: Visual Studio, Книги

Blogus tags : Visual Studio, Книги

Visual Studio Service Pack 1 (SP1)

Вышел релиз первого сервис пака для Visual Studio.

Подробнее: Visual Studio 2005 Service Pack 1 (SP1)

Through further advancement and feedback, Service Pack 1 also provides over 70 improvements for common development scenarios including:

• New processor support (e.g., Core Duo) for code generation and profiling
• Performance and scale improvements in Team Foundation Server
• Team Foundation Server integration with Excel 2007 and Project 2007
• Tool support for occasionally connected devices and SQL Server Compact Edition
• Additional support for project file based Web applications
• Windows Embedded 6.0 platform and tools support

Technorati tags: Visual Studio

Blogus tags : Visual Studio

Набор hotfix для Visual Studio 2005

На этой странице доступны текущие hotfix релизы для Visual Studio. Для загрузки потребуется наличие "Паспорта" (Windows Live ID). Многие из них в будущем войдут в первый Service Pack для Visual Studio.

Technorati tags: Visual Studio

Blogus tags : Visual Studio

Генератор документации для .NET Sandcastle

Средства генерирования документации меня занимают давно. Когда проблема стояла остро, я нашел Doxygen и больше ничего не рассматривал, так как полностью удовлетворил все мои запросы к таким инструментам. Программировал я в то время не столько на .NET, сколько на других языках, поэтому Doxygen подошел как нельзя лучше.

Скорее всего, из-за отсутствия потребности в .NET ориентированном генераторе, появление и развитие популярного NDoc, прошло мимо меня.

В настоящее время я активно присматриваюсь к Sandcastle от Microsoft и ниже подборка информации по этому проекту.

Лучше всего начать с отличной статьи Никиты Зимина на RSDN: Новый генератор документации для .NET. В его блоге можно найти информацию по локализации Sandcastle.

Остальные источники англоязычные, в основном пересекающиеся с источниками из статьи Никиты.

Презентация (не пропустите комментарии к слайдам) от автора системы, разъясняющая основные положения Sandcastle. Блог разработчиков. Форум на MSDN. Wiki проекта.

Статья по добавлению генерации документации Sandcastle в NAnt и еще одна на CodeProject: Generating MSDN-style documentation with Sandcastle, NAnt and CruiseControl.NET.

Пошаговая инструкция по генерации Chm и генератор BAT-файлов для автоматизации выполнения шагов инструкции (блог автора)

Для работы с SandCastle пригодится HTML Help Workshop, если он вдруг еще не стоит в системе.

Sandcastle Help File Builder - проект на CodePlex, дополняющий Sandcastle некоторыми возможностями NDoc и предоставляющий GUI в его стиле. Статья автора по использованию. И еще одна подробная статья: How To Generate Help Files for Your .NET Application Using Sandcastle Help File Builder.

MSBuild скрипты для Sandcastle - проект на CodePlex и блог автора для автоматизации генерации документации с помощью MSBuild.

Power Shell Script - скрипт Scott Hanselman для PowerShell и небольшой обзор.

SandCastle documentation cleaner - небольшая утилита для удаления частей документации, которые не предполагалось публиковать, например, помеченных как internal.

Addin для Visual Studio, позволяющий генерировать документацию в SandCastle непосредственно из Visual Studio.

Technorati tags: Sandcastle, Visual Studio

Blogus tags : Sandcastle,Visual Studio

Visual Studio .NET 2003 Service Pack 1

Microsoft выпустила Пакет обновления 1 (SP1) для Microsoft® Visual Studio® .NET™ 2003. Хотя уже прошло два месяца, как файл стал доступен для загрузки, я как-то пропустил это событие.

Release notes List of bugs that are fixed

Technorati tags: Visual Studio

Blogus tags : Visual Studio

Open XML File Format Code Snippets for Visual Studio 2005

Microsoft сделала доступным для загрузки 2007 Office System Sample: Open XML File Format Code Snippets for Visual Studio 2005 - обновленные snippet'ы для System.IO.Packaging API ориентированные на последнюю версию схемы OpenXML и RTM версии Office и .NET 3.0. Snippet'ы содержат код как для C#, так и для VB. Для работы потребуется установленный .NET 3.0 Framework, а вот Office 2007 иметь не обязательно.

Разработчикам для Office 2007 могут быть полезны следующие документы: 2007 Office System Document: Developer Overview of the User Interface, 2007 Office System: XML Schema Reference, 2007 Office System Document: UI Style Guide for Solutions and Add Ins, Walkthrough: Word 2007 XML Format и ресурсные центры XML in Office Developer Portal и .NET in Office Developer Portal

Подробнее о новом интерфейсе Office.

На CodePlex можно найти интересный инструмент: Word 2007 Content Control Toolkit, предназначенный для просмотра иерархии всех контент контролов в документе. Исходный код включен в состав установочного пакета.

Подробнее о формате OpenXML.

Technorati tags: Office, Visual Studio, .NET

Blogus tags : Office, Visual Studio, .NET

Утилиты для работы с Team Foundation Server

Вместе с выпуском Visual Studio 2005 Microsoft представила свою новую систему командной разработки Visual Studio Team System, доступную в редакции Visual Studio 2005 Team Suite, либо в качестве отдельных продуктов. Для полноценной работы необходимо установить Team Foundation Server (TFS), интегрирующую часть всей Team-системы.

Скачать пробную версию TFS-сервера, расчитанную на полгода работы. [447.6 MB]

Скачать пробную полугодичную версию Visual Studio 2005 Team Suite [3340.4 MB]

Ниже ссылки на дополнительную информацию по установке и вспомогательные утилиты.

Visual Studio 2005 Team Foundation Installation Guide - гид по развертыванию системы.

MSDN Forums Visual Studio Team System - официальный форум.

Team System Utilities - подборка ссылок на полезные бесплатные / open source утилиты, а так же Blog-разработчиков, некоторых из этих утилит.

Team System Utilities by Digerati Technologies, LLC - еще одна подборка инструментов для TFS, частично пересекающаяся с предыдущей.

Team Word - add-in для Microsoft Word 2003, предназначенный для превращения Word в инструмент для редактирования рабочих записей, позволяя пользователям вставлять рабочие элементы непосредственно из TFS. Подробнее о возможностях программы смотрите на страничке автора.

Team Foundation Sidekick - дополнение к Visual Studio, расширяющее функциональность Team Explorer'а для поддержки Team Build типов. Доступны исходные коды и статья, поясняющая процесс написания подобного addin'а.

Technorati tags: Visual Studio, TFS

Blogus tags : Visual Studio, TFS