Выполнение примеров Windows Communication Foundation

  • Статья

Примеры Windows Communication Foundation (WCF) можно запускать в конфигурации с одним компьютером или несколькими компьютерами. После передачи примеры готовы к выполнению на одном компьютере. При выполнении на нескольких компьютерах необходимо изменить параметры файла конфигурации примера. В следующих процедурах объясняется, как выполнить пример на одном компьютере или на нескольких компьютерах. Обратите внимание, что шаги, выполняемые для служб, размещенных в службах IIS, и шаги для резидентных примеров, отличаются. Большинство примеров размещаются в службах IIS; чтобы определить, как размещается пример, см. сведения в файле Readme.

В Windows Vista примеры, не размещенные в IIS, требуют повышенных привилегий для регистрации прослушивателя в Http.sys. Используйте средство Httpcfg.exe для регистрации адреса ожидания передачи данных службы, работающей под учетной записью службы, или запустите службу из командной строки с правами администратора.

Примечание.

Прежде чем создавать или запускать любой из примеров WCF, убедитесь, что вы выполнили процедуру однократной установки для примеров Windows Communication Foundation.

Запуск образца на том же компьютере

  1. Если служба размещена службами IIS, убедитесь, что вы можете получить доступ к службе с помощью браузера, введя следующий адрес: http://localhost/servicemodelsamples/service.svc Должна отобразиться страница подтверждения. Если страница подтверждения не отображается, см. сведения об устранении неполадок Советы для примеров WCF.

  2. Если служба является резидентной, запустите программу Service.exe из папки \service\bin\ в языковой папке. Действия службы отображаются в окне консоли службы.

  3. Запустите Client.exe из \client\bin\, из папки для конкретного языка. Действия клиента отображаются в окне консоли клиента.

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

Выполнение примера на нескольких компьютерах

  1. Служба размещается в службах IIS.

    1. На компьютере службы создайте виртуальный каталог с именем ServiceModelSamples. Пакетный файл Setupvroot.bat, включенный в процедуру однократной установки для примеров Windows Communication Foundation, можно использовать для создания каталога диска и виртуального каталога.

    2. Скопируйте файлы программы службы из каталога %SystemDrive%\Inetpub\wwwroot\servicemodelsamples в виртуальный каталог ServiceModelSamples на компьютере службы. Убедитесь, что включены все файлы каталога \bin.

    3. Убедитесь, что доступ к службе с клиентского компьютера можно получить из браузера.

    Служба является резидентной.

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

    2. Скопируйте на компьютер службы файлы программы службы из папки \service\bin\ в языковой папке.

    3. В файле конфигурации службы измените значение адреса определения конечной точки, чтобы оно соответствовало новому адресу службы. Замените любые ссылки на "localhost" в адресе полным именем домена.

    4. Запустите программу Service.exe из командной строки.

  2. Скопируйте на клиентский компьютер файлы программы клиента из папки \client\bin\ в языковой папке.

  3. Задайте адрес конечной точки.

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

    2. Если служба выполняется в учетной записи домена, заново создайте конфигурацию клиента, выполнив Svcutil.exe относительно службы. Дополнительные сведения о запуске Svcutil.exe см. в статье "Создание примеров Windows Communication Foundation". Используйте созданный файл вместо файла конфигурации в примере. В созданном файле конфигурации содержатся дополнительные данные идентификации (и содержатся все параметры, необходимые для подключения к конечной точке службы, даже если они являются параметрами по умолчанию). Дополнительные сведения об удостоверениях см. в разделе "Удостоверение службы" и "Проверка подлинности" и< "Идентификация>".

  4. На клиентском компьютере из командной строки запустите программу Client.exe.

Отладка службы

  1. Создайте решение (как клиент, так и службу) с помощью меню "Сборка" или CTRL+SHIFT+B.

  2. Служба размещается в службах IIS.

    1. Активируйте службу с помощью браузера, введя адрес http://localhost/servicemodelsamples/service.svc.

    2. В решении выберите меню отладки и пункт меню "Присоединить к процессу ".

    3. Установите флажок Показать процессы, запущенные всеми пользователями.

    4. Выберите рабочий процесс ведущего приложения W3wp.exe для отладки (в Windows XP выберите ASPNet_wp.exe).

  3. Теперь можно задать точки останова в коде службы и включить точки останова в исключениях.

  4. Щелкните правой кнопкой мыши элемент клиентского проекта и выберите "Отладка", "Запустить новый экземпляр".

Очистка после образца

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

См. также