Веб-ссылки и пользовательские прокси-классы клиента веб-службы в библиотеках классов

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

В конструкторе приложений можно представить веб-ссылки на веб-службы или пользовательские прокси-классы клиента веб-службы, которые определены в упоминаемых проектах или сборках в виде конечных точек потребителя веб-службы для приложений Windows, Office или ASP.NET. Чтобы выполнить данную задачу, необходимо выполнить определенные действия, чтобы отобразить эти элементы неявным образом в качестве конечных точек потребителя веб-службы и подключений к таким точкам.

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

Однако перед выполнением таких действий необходимо реализовать приложение-потребитель веб-службы, а в проекте приложения должен находиться файл конфигурации приложения (Web.config или App.config). Дополнительные сведения см. в разделе Реализация приложений на диаграммах приложений.

Требования к реконструированию веб-ссылок и пользовательских прокси-классов клиента веб-службы в библиотеках классов

Для приложений ASP.NET необходимо добавить соответствующие записи в файл конфигурации Web.config, а также должны быть доступны существующие прокси-классы с совпадающими полными именами. Однако для приложений Windows и Office достаточно наличия таких записей в файле конфигурации App.config при условии, что они обозначены типом WebServiceURL. Если же такие записи не обозначены типом WebServiceURL или обозначены типом String то также должны быть доступны существующие прокси-классы с совпадающими полными именами. Дополнительные сведения см. в разделе Вопросы использования пользовательских прокси-классов клиента веб-службы.

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

Если выполнены эти требования, конструктор приложений выполняет реконструирование таких записей файла конфигурация в виде конечных точек потребителя веб-службы. Кроме того, если URL-адреса веб-служб, заданные в этих записях, совпадают с URL-адресами существующих конечных точек поставщика веб-службы, то также образуются подключения между такими конечными точками потребителя и поставщика. Если не существуют совпадающие конечные точки поставщика веб-службы, но URL-адрес можно использовать для указания на допустимый WSDL-файл для веб-службы путем добавления к URL-адресу строки "?wsdl" или "?disco", то на диаграмму приложения добавляется внешняя веб-служба, которая подключается к конечной точке потребителя веб-службы. Если с помощью URL-адреса нельзя определить расположение WSDL-файла, то конечная точка потребителя веб-службы остается неподключенной.

Изменения, распространяющиеся на неявные конечные точки потребителя веб-службы

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

• Создание или удаление подключений к неявным конечным точкам потребителя веб-службы на диаграмме приложения добавляет URL-адрес подключенной веб-службы в файл конфигурации приложения-потребителя или удаляет URL-адрес из этого файла.

• Удаление неявных конечных точек потребителя веб-службы на диаграмме приложения удаляет соответствующие записи файла конфигурации, но не удаляет веб-ссылки или пользовательские прокси-классы из библиотеки классов.

  Примечание.
  Если удаляется неявная конечная точка, убедитесь, что в приложении и в упоминаемых библиотеках классов не содержатся ссылки на соответствующую запись файла конфигурации.

• При удалении или переименовании прокси-класса в проекте или сборкой, упоминаемой в приложении ASP.NET, удаляется соответствующая конечная точка потребителя веб-службы.

  Это происходит из-за того, что запись файла конфигурации перестает соответствовать прокси-классу. Конечная точка потребителя вновь появляется, когда добавляется прокси-класс с совпадающим именем.

• В результате копирования и вставки конечных точек потребителя веб-службы, веб-ссылки которых располагаются в библиотеке классов или в сборке, веб-ссылки для вставляемых конечных точек появляются в корневом проекте.

См. также

Ссылки

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

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

Ссылки на библиотеки классов из приложений на диаграммах приложений