Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Для проектов .NET Framework ссылка на службу позволяет проекту получить доступ к одной или нескольким службам данных WCF. Используйте диалоговое окно "Добавление ссылки на службу" для поиска служб данных WCF в текущем решении, локально, в локальной сети или в Интернете.
Для проектов .NET Core можно использовать узел подключенных служб в обозревателе решений для доступа к поставщику ссылок на веб-службы Microsoft WCF, который позволяет управлять ссылками на службы данных Windows Communication Foundation (WCF).
Замечание
На компьютере могут отображаться различные имена или расположения для некоторых элементов пользовательского интерфейса Visual Studio в этой статье. Возможно, вы используете другой выпуск Visual Studio или разные параметры среды. Дополнительные сведения см. в разделе Персонализация интегрированной среды разработки.
Предпосылки
Средства 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 Data Services и WCF) в текущем решении добавляются в список служб .
В списке служб разверните узел для службы, которую вы хотите использовать, и выберите набор сущностей.
В поле пространства имен введите пространство имен, которое вы хотите использовать для ссылки.
Нажмите кнопку "ОК ", чтобы добавить ссылку на проект.
Клиент службы (прокси-сервер) создает и метаданные, описывающие службу, добавляются в файлapp.config .
Добавление ссылки на службу в текущем решении (проекты .NET Core)
В Обозревателе решений дважды щелкните узел Подключенных служб или коснитесь его.
Откроется вкладка "Настройка служб ".
Выберите поставщика справочника по веб-службам Microsoft WCF.
Откроется диалоговое окно "Настройка ссылки на веб-службу WCF ".
Нажмите кнопку "Обнаружить".
Все службы (службы WCF Data Services и WCF) в текущем решении добавляются в список служб .
В списке служб разверните узел для службы, которую вы хотите использовать, и выберите набор сущностей.
В поле пространства имен введите пространство имен, которое вы хотите использовать для ссылки.
Нажмите кнопку "Готово ", чтобы добавить ссылку на проект.
Клиент службы (прокси-сервер) создает и метаданные, описывающие службу, добавляются в файлapp.config .
Обновление ссылки на службу
Модель данных сущности для служб данных WCF иногда изменяется. В этом случае необходимо обновить ссылку на службу.
Обновление ссылки на службу
В обозревателе решений щелкните правой кнопкой мыши ссылку на службу и выберите "Обновить ссылку на службу".
Диалоговое окно процесса выполнения отображается во время обновления ссылки из исходного расположения, и клиент службы регенерируется для отражения изменений в метаданных.
Для проектов .NET Core используйте dotnet-svcutil. Сведения об установке и инструкциях см. в dotnet-svcutil .
Для проектов .NET Framework:
В обозревателе решений разверните узел "Подключенные службы" , щелкните правой кнопкой мыши ссылку на службу и выберите "Обновить ссылку на службу".
Диалоговое окно процесса выполнения отображается во время обновления ссылки из исходного расположения, и клиент службы регенерируется для отражения изменений в метаданных.
Удаление ссылки на службу
Если ссылка на службу больше не используется, ее можно удалить из решения.
Удаление ссылки на службу
В обозревателе решений щелкните правой кнопкой мыши ссылку на службу и выберите пункт "Удалить".
Клиент службы будет удален из решения, а метаданные, описывающие службу, будут удалены из файла app.config .
Замечание
Любой код, ссылающийся на ссылку на службу, должен быть удален вручную.