Пример визуализатора запросов LINQ

Статья
11/05/2008

Обновлен: Ноябрь 2007

Визуализатор запросов — это сборка, которую можно использовать в сеансе отладки Visual Studio для наглядного отображения запросов к базе данных. Сам по себе проект является библиотекой и не может быть запущен. При его компиляции создается DLL-библиотека, которую можно использовать в Visual Studio для расширения возможностей по отладке приложений LINQ to SQL.

Примечание.
При отладке приложений с помощью визуализатора может потребоваться добавить в строку подключения текст Persist Security Info=true. При включении отладчика он сериализует данные из отлаживаемой программы и отправляет эти данные процессу, который отображает визуализатор. В частности, сериализуется строка подключения, получаемая из объекта SqlConnection. По умолчанию объект SqlConnection не возвращает пароль, поэтому строка подключения без пароля сериализуется и отправляется визуализатору. При попытке выполнения запроса в визуализаторе может возникнуть сбой, поскольку отсутствует пароль. Этот параметр следует использовать только при отладке. Не рекомендуется использовать его при создании рабочих версий кода.

При отладке приложений с помощью визуализатора может потребоваться добавить в строку подключения текст Persist Security Info=true. При включении отладчика он сериализует данные из отлаживаемой программы и отправляет эти данные процессу, который отображает визуализатор. В частности, сериализуется строка подключения, получаемая из объекта SqlConnection. По умолчанию объект SqlConnection не возвращает пароль, поэтому строка подключения без пароля сериализуется и отправляется визуализатору. При попытке выполнения запроса в визуализаторе может возникнуть сбой, поскольку отсутствует пароль. Этот параметр следует использовать только при отладке. Не рекомендуется использовать его при создании рабочих версий кода.

Получение примеров и инструкций по их установке

Выполните одно или несколько из следующих действий:
- В меню Справка выберите пункт Примеры.
  
  Отобразится информация о примерах, содержащаяся в файле сведений о продукте.
- Посетите веб-узел примеров Visual Studio 2008 Здесь содержатся самые последние версии примеров.
- Найдите примеры на компьютере, где установлена среда Visual Studio. По умолчанию примеры и файл сведений о продукте устанавливаются в папку диск:\Program Files\Microsoft Visual Studio 9.0\Samples\lcid. Для выпусков Express продукта Visual Studio все примеры располагаются в Интернете.

Дополнительные сведения см. в разделе Поиск файлов примеров.

Примечание о безопасности.
Этот пример кода иллюстрирует концепцию и содержит только код, относящийся к этой концепции. Он может не отвечать требованиям безопасности для конкретных условий, и его не следует использовать в точности в том виде, в каком он приведен. Чтобы проект был безопасным и надежным, рекомендуется добавить код обеспечения безопасности и код обработки ошибок. Корпорация Майкрософт предоставляет этот пример кода на условиях “как есть”, без каких-либо гарантий.

Этот пример кода иллюстрирует концепцию и содержит только код, относящийся к этой концепции. Он может не отвечать требованиям безопасности для конкретных условий, и его не следует использовать в точности в том виде, в каком он приведен. Чтобы проект был безопасным и надежным, рекомендуется добавить код обеспечения безопасности и код обработки ошибок. Корпорация Майкрософт предоставляет этот пример кода на условиях “как есть”, без каких-либо гарантий.

Для выполнения этого примера

Откройте и постройте проект визуализатора запросов.
Скопируйте DLL-библиотеку, созданную при компиляции, из папки bin вашего проекта в папку Visualizers, которая по умолчанию находятся по адресу C:\Users\имя_пользователя\Документы\Visual Studio 2008\Visualizers. Может потребоваться создать папку Visualizers. В Windows XP и более ранних версиях используйте папку "Мои документы" вместо "Документы". При наличии необходимых разрешений также можно скопировать файл в следующую папку: ...\Program Files\Microsoft Visual Studio 9.0\Common7\Packages\Debugger\Visualizers.
При необходимости нужно перезапустить Visual Studio, чтобы убедиться в распознавании визуализатора.
Проверьте визуализатор на существующем примере проекта, таком как SampleQueries, или создайте новое консольное приложение для проверки визуализатора. Для создания нового приложения выполните следующие действия.
1. Создайте консольное приложение по умолчанию.
2. Используйте Сред. Объектно-реляционный конструктор для присоединения к базе данных "Борей", находящейся в папке примеров.
3. Откройте окно Добавить новый элементы (Ctrl-Shift-A) и щелкните Классы LINQ to SQL.
4. Откройте обозреватель серверов (Ctrl + W, L).
5. В обозревателе серверов нажмите на кнопку Подключиться к базе данных. При необходимости в диалоговом окне Источник данных выберите Файл базы данных Microsoft SQL Server. Найдите базу данных Northwind.mdb в папке Data, находящейся в папке примеров.
6. Перетащите таблицу Customers на рабочую область конструктора.
7. Напишите и вызовите простой запрос, такой как показано ниже:
```
public void SimpleQuery()
{
    DataClasses1DataContext db = new DataClasses1DataContext();
    var query = from c in db.Customers
                select c;
    foreach (var item in query)
        Console.WriteLine(item.CompanyName);
}
```
8. Установите точку останова на строке foreach и выполните программу до нее.
9. Наведите указатель мыши на запрос имени переменной и щелкните значок лупы.

Демонстрации

Визуализатор запросов — это полезная вспомогательная программа, которую можно запустить в отладчике.

Примечание.
Для многих примеров LINQ требуется XML и образец базы данных "Борей", находящийся в примере Data. При установке Пример "Data" в ту же родительскую папку, что и другие примеры LINQ путь к XML-файлам и файлу базы данных будет определен автоматически. Кроме того, для многих файлов примеров требуется проект Пример сборщика объектов.

Для многих примеров LINQ требуется XML и образец базы данных "Борей", находящийся в примере Data. При установке Пример "Data" в ту же родительскую папку, что и другие примеры LINQ путь к XML-файлам и файлу базы данных будет определен автоматически. Кроме того, для многих файлов примеров требуется проект Пример сборщика объектов.

См. также

Другие ресурсы

Примеры LINQ на языке C#

Приступая к работе (LINQ to XML)

Поделиться через