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

Используйте средство ссылки на веб-службы WCF

На протяжении многих лет многие разработчики Visual Studio наслаждались производительностью, предоставляемой средством "Добавить справочник по службам ", если их проекты .NET Framework необходимы для доступа к веб-службам.

Инструмент WCF Web Service Reference — это подключаемое расширение службы Visual Studio, позволяющее подключать проект .NET 5+, .NET Core или ASP.NET Core к веб-службе. Он предоставляет интерфейс, аналогичный функциональным возможностям "Добавить справочник по службам ", который предназначен только для проектов .NET Framework. Инструмент WCF Web Service Reference извлекает метаданные из веб-службы в текущем решении, по сетевому адресу или из WSDL-файла и создает исходный файл, содержащий код клиентского прокси Windows Communication Foundation (WCF), который ваше приложение .NET может использовать для доступа к веб-службе.

Это важно

Следует ссылаться только на службы из надежного источника. Добавление ссылок из ненадежного источника может компрометировать безопасность.

Предпосылки

Снимки экрана, приведенные в этой статье, относятся к Visual Studio 2022.

Использование расширения

Замечание

Средство справочника по веб-службам WCF применимо только к проектам .NET Core и .NET Standard C#, включая ASP.NET веб-приложения Core.

В качестве примера используется шаблон проекта веб-приложения ASP.NET Core , в этой статье описывается добавление ссылки на службу WCF в проект.

  1. В обозревателе решения дважды щелкните узел Подключенные службы проекта. (Для проекта .NET Core или .NET Standard щелкните проект правой кнопкой мыши и нажмите кнопку "Добавить".>Подключенная служба.)

    Страница "Подключенные службы" отображается, как показано на следующем рисунке:

    Вкладка

  2. На странице "Подключенные службы" выберите "Добавить ссылку на службу".

    Откроется страница "Добавить ссылку на службу ".

  3. Выберите веб-службу WCF и нажмите кнопку "Далее".

    Откроется мастер добавления новой ссылки веб-службы WCF .

    Вкладка

  4. Выберите службу.

    a. Доступны несколько вариантов поиска служб:

    • Чтобы найти службы, определенные в текущем решении, нажмите кнопку "Обнаружить ".
    • Чтобы найти службы, размещенные по указанному адресу, введите URL-адрес службы в поле "Адрес " и нажмите кнопку "Перейти ".
    • Чтобы выбрать WSDL-файл, содержащий сведения о метаданных веб-службы, нажмите кнопку "Обзор ".

    б. Выберите службу из списка результатов поиска в поле "Службы ". При необходимости введите пространство имен для созданного кода в соответствующее текстовое поле Namespace.

    с. Нажмите кнопку "Далее ", чтобы указать параметры типа данных или параметры клиента. Кроме того, нажмите кнопку "Готово ", чтобы использовать параметры по умолчанию.

  5. Страница параметров типа данных позволяет уточнить параметры конфигурации созданной ссылки на службу:

    Вкладка

    Замечание

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

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

  6. После завершения нажмите кнопку "Готово ".

При отображении хода процесса инструмент:

  • Загружает метаданные из службы WCF.
  • Создает код ссылки на службу в файле с именем reference.cs и добавляет его в проект в узле "Подключенные службы ".
  • Обновляет файл проекта (CSPROJ) со ссылками на пакет NuGet, необходимые для компиляции и запуска на целевой платформе.

Окно прогресса Visual Studio

По завершении этих процессов можно создать экземпляр созданного типа клиента WCF и вызвать операции службы.

См. также

Отзывы и вопросы

Если у вас есть отзывы о продукте, сообщите об этом в сообществе разработчиков с помощью средства отчета о проблеме .

Примечания к релизу

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