Замок из песка - все еще правильная вещь использовать? Или есть ли альтернативы? [закрытый]
Если вы хотите избежать зависимости от System.Web, которая требуется для использования HttpUtility.ParseQueryString , вы можете использовать метод расширения Uri ParseQueryString из System.Net.Http.
Обратите внимание, что вы должны преобразовать тело ответа в действительное Uri, чтобы ParseQueryString работал.
Также обратите внимание, что в документе MSDN этот метод является методом расширения для класса Uri, поэтому вам необходимо обратиться к сборке System.Net.Http.Formatting (в System.Net.Http.Formatting.dll). Я попытался установить его с помощью пакета nuget с именем «System.Net.Http.Formatting», и он отлично работает.
string body = "value1=randomvalue1&value2=randomValue2";
// "http://localhost/query?" is added to the string "body" in order to create a valid Uri.
string urlBody = "http://localhost/query?" + body;
NameValueCollection coll = new Uri(urlBody).ParseQueryString();
6 ответов
Никто не упомянул Docu, недавний проект, инициированный Джеймсом Грегори, руководителем разработки FluentNHibernate.
Это очень простой и легкий в использовании инструмент, который генерирует html-документацию а-ля rdoc . Вы можете легко изменять шаблоны, так как Docu использует Spark в качестве механизма представления.
Вот документация FluentNHibernate , созданная с помощью Docu.
Microsoft Sandcastle, безусловно, по-прежнему верный путь. Основной альтернативой (которая предлагает что-то близкое к набору функций Sandcastle) является NDoc , но последний выпуск этого намного старше, он был выпущен в январе 2005 года!
Хотя технически он все еще находится в (поздно ) на стадии pre-release, это на самом деле довольно стабильный инструмент. Небольшое количество ошибок было исправлено патчами, доступными на CodePlex как часть проекта Sandcastle Styles . Для него также есть превосходный графический интерфейс, а именно Sandcastle Help File Builder .
Однако я не уверен в будущем развитии Sandcastle. Я считаю, что, вероятно, Microsoft продолжит работу / расширение в какой-то момент, хотя, похоже, нет никаких новостей о том, когда. На данный момент это, безусловно, единственный достойный инструмент для создания надлежащей документации для библиотеки или приложения .NET. Конечно, часто можно обойтись более «легковесными» инструментами для небольших проектов / файлов помощи. Основные альтернативы, которые я заметил, являются одновременно коммерческими и уступают Sandcastle.
Создание документации вручную / с использованием пользовательской автоматизации, вероятно, возможно в определенных случаях, но только для небольших проектов (которые вряд ли будут расширяться).
Sandcastle по-прежнему правильный выбор. Я использовал его для многих проектов в прошлом.
В любом случае взгляните на эти:
Насколько мне известно, Sandcastle по-прежнему является правильным выбором. Я использовал его много раз в недавнем прошлом и у меня нет проблем. Вы можете проверить эту страницу в MSDN и прокрутить вниз до раздела «Документация», чтобы найти другие хорошие варианты:
DocProject заслуживает внимания. Это снимает много боли при работе с замком из песка.
В этом вопросе SO я поместил краткий список некоторых инструментов документации: any-using-ndoc-or-a-similar-tool
Я думаю, что SandCastle - лучший инструмент с открытым исходным кодом в настоящее время (для документирования .NET-проектов), но есть несколько коммерческих инструментов, и они могут предложить лучшую производительность и больше функций, поэтому, если у вас есть бюджет на одну из них, стоит хотя бы оценить, какую ценность она может вам принести.