Добавление, обновление или удаление ссылки на службу данных WCF
Для платформа .NET Framework проектов ссылка на службу позволяет проекту получить доступ к одной или нескольким службы данных WCF. Используйте диалоговое окно "Добавить ссылку на службу" для поиска службы данных WCF в текущем решении, локально, в локальной сети или в Интернете.
Для проектов .NET Core можно использовать узел подключенных служб в Обозреватель решений для доступа к поставщику ссылок на веб-службы Microsoft WCF, который позволяет управлять ссылками на службы данных Windows Communication Foundation (WCF).
Примечание.
Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в этой статье. Возможно, вы используете другой выпуск Visual Studio или разные параметры среды. Дополнительные сведения см. в разделе Персонализация среды IDE.
Необходимые компоненты
Средства WCF не установлены с рабочей нагрузкой .NET; используйте Visual Studio Installer для изменения установки. В установщике выберите Windows Communication Foundation в разделе "Отдельные компоненты". См. раздел Изменение Visual Studio.
Добавление ссылки на службу WCF
Добавление ссылки на внешнюю службу (проекты платформа .NET Framework)
В Обозреватель решений щелкните правой кнопкой мыши имя проекта, в который нужно добавить службу, а затем выберите "Добавить ссылку на службу".
Откроется диалоговое окно "Добавить ссылку на службу".
В поле "Адрес" введите URL-адрес службы и нажмите кнопку "Перейти" для поиска службы. Если служба реализует имя пользователя и безопасность паролей, вам может потребоваться указать имя пользователя и пароль. Вы также можете выбрать службу в своем решении. Нажмите кнопку "Обнаружить ", а затем выберите "Службы" в решении.
Примечание.
Ссылаться на службы следует только из надежного источника. Добавление ссылок из ненадежного источника может компрометации безопасности.
Вы также можете выбрать URL-адрес из списка адресов , в котором хранятся предыдущие 15 URL-адресов, по которым найдены допустимые метаданные службы.
Индикатор хода выполнения отображается при выполнении поиска. Вы можете остановить поиск в любое время, нажав кнопку "Остановить".
В списке служб разверните узел для службы, которую вы хотите использовать, и выберите набор сущностей.
В поле пространства имен введите пространство имен, которое вы хотите использовать для ссылки.
Нажмите кнопку "ОК ", чтобы добавить ссылку на проект.
Создается клиент службы (прокси-сервер), а метаданные, описывающие службу, добавляются в файл app.config .
Добавление ссылки на внешнюю службу (проекты .NET Core, включая .NET 5 и более поздние версии)
В Обозреватель решений дважды щелкните узел "Подключенные службы".
Откроется вкладка "Настройка служб ".
Выберите поставщика справочника по веб-службам Microsoft WCF.
Откроется диалоговое окно "Настройка ссылки на веб-службу WCF".
В поле URI введите URL-адрес службы, а затем выберите "Перейти" для поиска службы. Если служба реализует имя пользователя и безопасность паролей, вам может потребоваться указать имя пользователя и пароль.
Примечание.
Ссылаться на службы следует только из надежного источника. Добавление ссылок из ненадежного источника может компрометации безопасности.
Вы также можете выбрать URL-адрес из списка URI , в котором хранятся предыдущие 15 URL-адресов, по которым найдены допустимые метаданные службы.
Индикатор хода выполнения отображается при выполнении поиска. Вы можете остановить поиск в любое время, нажав кнопку "Остановить".
В списке служб разверните узел для службы, которую вы хотите использовать, и выберите набор сущностей.
В поле пространства имен введите пространство имен, которое вы хотите использовать для ссылки.
Нажмите кнопку "Готово ", чтобы добавить ссылку на проект.
Создается клиент службы (прокси-сервер), а метаданные, описывающие службу, добавляются в файл app.config .
Добавление ссылки на службу в текущем решении (платформа .NET Framework проекты)
В Обозреватель решений щелкните правой кнопкой мыши имя проекта, в который нужно добавить службу, а затем выберите "Добавить ссылку на службу".
Откроется диалоговое окно "Добавить ссылку на службу".
Нажмите кнопку " Обнаружить".
Все службы (как службы данных WCF, так и службы WCF) в текущем решении добавляются в список служб.
В списке служб разверните узел для службы, которую вы хотите использовать, и выберите набор сущностей.
В поле пространства имен введите пространство имен, которое вы хотите использовать для ссылки.
Нажмите кнопку "ОК ", чтобы добавить ссылку на проект.
Клиент службы (прокси-сервер) создает и метаданные, описывающие службу, добавляются в файл app.config .
Добавление ссылки на службу в текущем решении (проекты .NET Core)
В Обозреватель решений дважды щелкните узел "Подключенные службы".
Откроется вкладка "Настройка служб ".
Выберите поставщика справочника по веб-службам Microsoft WCF.
Откроется диалоговое окно "Настройка ссылки на веб-службу WCF".
Нажмите кнопку " Обнаружить".
Все службы (как службы данных WCF, так и службы WCF) в текущем решении добавляются в список служб.
В списке служб разверните узел для службы, которую вы хотите использовать, и выберите набор сущностей.
В поле пространства имен введите пространство имен, которое вы хотите использовать для ссылки.
Нажмите кнопку "Готово ", чтобы добавить ссылку на проект.
Клиент службы (прокси-сервер) создает и метаданные, описывающие службу, добавляются в файл app.config .
Обновление ссылки на службу
Модель данных сущности для службы данных WCF иногда изменяется. В этом случае необходимо обновить ссылку на службу.
Обновление ссылки на службу
В Обозреватель решений щелкните правой кнопкой мыши ссылку на службу и выберите "Обновить ссылку на службу".
Диалоговое окно хода выполнения отображается во время обновления ссылки из исходного расположения, и клиент службы повторно создается для отражения любых изменений в метаданных.
Для проектов .NET Core используйте dotnet-svcutil это средство. Сведения об установке и инструкциях см. в dotnet-svcutil .
Для проектов платформа .NET Framework:
В Обозреватель решений разверните узел "Подключенные службы", щелкните правой кнопкой мыши ссылку на службу и выберите "Обновить ссылку на службу".
Диалоговое окно хода выполнения отображается во время обновления ссылки из исходного расположения, и клиент службы повторно создается для отражения любых изменений в метаданных.
Удаление ссылки на службу
Если ссылка на службу больше не используется, ее можно удалить из решения.
Удаление ссылки на службу
В Обозреватель решений щелкните правой кнопкой мыши ссылку на службу и нажмите кнопку "Удалить".
Клиент службы будет удален из решения, и метаданные, описывающие службу, будут удалены из файла app.config .
Примечание.
Любой код, ссылающийся на ссылку на службу, должен быть удален вручную.