Пошаговое руководство. Подключение к данным в веб-службе (Windows Forms)

В этом пошаговом руководстве показано, как подключить приложение к веб-службе с помощью мастера мастер настройки источника данных. Будет необходимо подключиться к веб-службе "Поиск Live" и запустить поисковые запросы из приложения. Возвращенные службой данные (результаты поиска) будут отображены в форме Windows Forms.

В этом пошаговом руководстве демонстрируется выполнение следующих задач.

Создание нового проекта Приложение Windows.

Добавление ссылки на службу в приложение (подключение к службе "Поиск Live").

Добавление элементов управления для выполнения поисковых запросов (вызов методов, предоставляемых службой).

Создание кода для доступа к службе и возвращения данных.

Привязка данных, возвращенных службой к элементу BindingSource.

Отображение возвращенных службой данных в сетке.

Получение AppID

Идентификатор AppID из поиска Live бесплатен и служит для уникальной идентификации приложения в службе "Поиск Live". Этот идентификатор необходим для доступа к службе.

Перейдите по адресу http://search.live.com/developer и получите бесплатный идентификатор AppID

Может понадобиться некоторое время (30-60 минут) для проверки AppID в службе.Если в течение этого времени возникнет общая ошибка клиента при выполнении приложения, возможно, что идентификатор AppID все еще находится в обработке на серверах поиска Live.

Создание проекта

В меню Файл создайте новый проект.

Выберите Приложение Windows Forms и назовите его WebServiceWalkthrough.

Нажмите кнопку ОК.

Проект создается и добавляется в Обозреватель решений.

Подключение к службе

Подключитесь к службе, выполнив мастер настройки источника данных.

В меню Данные выберите пункт Показать источники данных.

В окне Источники данных выберите элемент Добавить новый источник данных.

На странице Выбор типа источника данных выберите Служба и нажмите кнопку Далее.

Введите http://soap.search.msn.com/webservices.asmx?wsdl в поле URL-адрес диалогового окна Добавление ссылки на службу.

Щелкните Перейти.

После обнаружения веб-службы, измените пространство имен на LiveSearchService.

Нажмите кнопку ОК, затем нажмите кнопку Готово для добавления в проект ссылки на службу.

Ссылка на службу будет добавлена в проект, а окно Источники данных будет заполнено на основе элементов, возвращенных службой.

Так как различные веб-службы предоставляют различные функции, следующие действия в этом пошаговом предназначены для получения данных из веб-службы "Поиск Live".Стандартный процесс получения данных из службы заключается в создании экземпляра службы с последующим вызовом методов, предоставляемых службой.После перетаскивания элементов из окна "Источники данных" в форме должен содержаться компонент BindingSource; задайте свойство DataSource равным данным, возвращенным службой.

Создание объекта DataGridView для отображения данных, возвращенных службой

Создайте сетку данных для привязанных данных путем перетаскивания элементов из окна Источники данных на форму. После добавления сетки настройте столбы для отображения только нужных столбцов. Затем задайте ссылку в столбце URL-адреса, чтобы пользователи могли щелкнуть этот URL-адрес и перейти на веб-сайты, возвращенные поисковым запросом.

Разверните узел SearchResponse в окне Источники данных.

Разверните узел Ответы.

Перетащите узел Результаты на форму.

На форму будут добавлены объекты DataGridView, BindingSource и BindingNavigator

Выберите объект resultsDataGridView, который был добавлен на форму.

В окне Свойства выберите свойство Columns и щелкните многоточие (. ), чтобы открыть диалоговое окно Диалоговое окно "Правка столбцов" (режим конструктора).

Выберите столбец URL-адрес и задайте следующие значения:

Для свойства ColumnType значение DataGridViewLinkColumn.

Для свойства AutoSizeMode значение AllCells.

Удалите все столбцы, кроме Заголовок, Описание и URL-адрес.

Нажмите кнопку ОК.

Добавление элементов управления для ввода критериев поиска и выполнения поискового запроса

Добавление элементов управления на существующую панель инструментов для запуска поисковых запросов.

На панели инструментов формы щелкните правой кнопкой мыши значок диска, который отображается в сером цвете, и последовательно выберите "Вставить" и TextBox.

В окне Свойства задайте для свойства Name значение searchCriteriaTextBox.

Задайте свойству Text значение Visual Studio.

Добавьте кнопку на панель инструментов и назовите ее searchButton.

В окне Свойства задайте значение свойства DisplayStyle, равное Text.

Задайте для свойства Текст значение "Поиск".

Создание обработчика событий для открытия веб-сайта по щелчку объектов в сетке

Добавьте обработчик события для события CellContentClick.

Выберите в форме объект resultsDataGridView, затем нажмите кнопку "События" в окне Свойства. Кнопка "События" — это кнопка со значком молнии.

Дважды щелкните событие CellContentClick для создания и перехода к заглушке обработчика.

Добавьте код для проверки щелчка столбца и перехода на веб-страницу при подтверждении щелчка столбца "URL-адрес":

Добавление кода для доступа к службе "Поиск Live" и выполнения поискового запроса

Обратитесь к службе, создав экземпляр службы в приложении и вызвав методы, предоставляемые службой.

Откройте форму Form1 в редакторе кода.

Добавьте в форму Form1 следующий метод:

Замените строку searchRequest.AppID = "AppID" на значение AppID, полученное от службы "Поиск Live".

Создание обработчика события для выполнения поиска при нажатии кнопки "Поиск".

Создайте обработчик события searchButton.Click и вызовите метод RunSearchRequest.

Откройте форму Form1 в режиме конструктора.

Дважды нажмите кнопку Поиск.

Добавьте следующую строку кода в созданный обработчик событий:

Запуск приложения

Запустите приложение и выполните поиск.

Запустите приложение (нажмите клавишу F5).

Нажмите кнопку Поиск для выполнения в сети поискового запроса Visual Studio — текста, заданного в searchCriteriaTextBox по умолчанию.

В сетке будут отображены первые десять результатов поиска.

Щелкните один из URL-адресов для перехода на веб-страницу.

В текстовом поле введите погода в Москве и нажмите кнопку Поиск.

В сетке будут отображаться новые результаты поиска.

Следующие действия

Доступ к службе "Поиск Live" необходим для понимания путей отображения данных, возвращенных службой, с использованием функций привязки к данным в приложениях Windows Forms. После подключения к другой службе и перетаскивания элементов из окна Источники данных в форме должен содержаться компонент BindingSource; задайте свойство DataSource равным данным, возвращенным службой. Дополнительные сведения см. в разделе Общие сведения о компоненте BindingSource.

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

Выберите элементы в окне Источники данных и перетащите их на форму. Дополнительные сведения см. в разделе Привязка элементов управления Windows Forms к данным в Visual Studio.

Создайте экземпляр службы в форме.

Задайте для созданного свойства DataSource значение, равное данным, возвращенным службой.