Практическое руководство. Добавление, обновление или удаление ссылки на службу

Ссылки на службу позволяют проекту использовать одну или несколько служб Windows Communication Foundation (WCF). В диалоговом окне Добавить ссылку на службу можно выполнять поиск служб WCF в текущем решении, локально, в локальной сети или в Интернете.

Добавление ссылки на службу

Чтобы добавить ссылку на внешнюю службу

  1. В обозревателе решений щелкните правой кнопкой мыши имя проекта, к которому требуется добавить службу, а затем щелкните Добавить ссылку на службу.

    Появится диалоговое окно Добавить ссылку на службу.

  2. В поле Address введите URL-адрес для службы и нажмите кнопку Перейти, чтобы выполнить поиск этой службы. Если эта служба защищена именем пользователя/паролем, то вам может быть предложено ввести имя пользователя и пароль.

    Примечание

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

    Примечание

    Можно также выбрать URL-адрес из раскрывающегося списка, в котором хранятся последние 15 найденных URL-адресов допустимых метаданных служб.

    Во время выполнения поиска выводится индикатор выполнения. Процесс поиска можно остановить в любое время, щелкнув кнопку Остановить.

  3. В списке Службы разверните узел нужной службы и выберите контракт службы.

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

  5. Нажмите кнопку ОК, чтобы добавить службу к проекту.

    Создается клиент службы (прокси), и метаданные, описывающие эту службу, добавляются в файл app.config.

Чтобы добавить ссылку на службу в текущее решение

  1. В обозревателе решений щелкните правой кнопкой мыши имя проекта, к которому требуется добавить службу, а затем щелкните Добавить ссылку на службу.

    Появится диалоговое окно Добавить ссылку на службу.

  2. Щелкните Найти.

    Все службы WCF в текущем решении добавляются в список Службы.

  3. В списке Службы разверните узел нужной службы и выберите контракт службы.

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

  5. Нажмите кнопку ОК, чтобы добавить службу к проекту.

  6. Создается клиент службы (прокси), и метаданные, описывающие эту службу, добавляются в файл app.config.

Обновление ссылки на службу

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

Чтобы обновить ссылку на службу

  • В Обозревателе решений щелкните правой кнопкой мыши нужную ссылку на службу, а затем нажмите Обновить ссылку на службу.

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

Удаление ссылки на службу

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

Чтобы удалить ссылку на службу

  • В Обозревателе решений щелкните правой кнопкой мыши нужную ссылку на службу, а затем нажмите Удалить.

    Клиент службы будет удален из решения, и метаданные, описывающие эту службу, будут удалены из файла app.config.

    Примечание

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

См. также

Задачи

Практическое руководство. Добавление ссылки на веб-службу

Ссылки

Диалоговое окно "Добавить ссылку на службу"

Основные понятия

Службы Windows Communication Foundation и службы данных WCF в Visual Studio

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

Consuming ASMX and WCF Services Sample