Настройка службы активации процессов Windows для использования с Windows Communication Foundation Configuring the Windows Process Activation Service for Use with Windows Communication Foundation
В этом разделе описываются шаги, необходимые для настройки службы активации Windows (также известной как WAS) в Windows Vista для размещения служб Windows Communication Foundation (WCF), не передающих сетевые протоколы HTTP. This topic describes the steps required to set up Windows Process Activation Service (also known as WAS) in Windows Vista to host Windows Communication Foundation (WCF) services that do not communicate over HTTP network protocols. Настройка предполагает следующие шаги. The following sections outline the steps for this configuration:
Установите (или подтвердите установку) необходимые компоненты активации WCF. Install (or confirm the installation of) the WCF activation components required.
Создайте узел WAS с привязками сетевых протоколов, которые планируется использовать, или добавьте новую привязку протокола в существующий узел. Create a WAS site with the network protocol bindings you wish to use, or add a new protocol binding to an existing site.
Создайте приложение для размещения служб и разрешите этому приложению использовать требуемые сетевые протоколы. Create an application to host your services and enable that application to use the required network protocols.
Создайте службу WCF, которая предоставляет конечную точку, отличную от HTTP. Build a WCF service that exposes a non-HTTP endpoint.
Настройка узла с привязками протоколов, отличных от HTTP Configuring a Site with Non-HTTP bindings
Для использования в сочетании со службой WAS привязки к протоколу, отличному от HTTP, необходимо добавить привязку узла в конфигурацию WAS. To use a non-HTTP binding with WAS, the site binding must be added to the WAS configuration. Хранилищем конфигурации для службы WAS является файл applicationHost.config, находящийся в каталоге %windir%\system32\inetsrv\config. The configuration store for WAS is the applicationHost.config file, located in the %windir%\system32\inetsrv\config directory. Это хранилище конфигурации используется и службой WAS, и службами IIS 7.0. This configuration store is shared by both WAS and IIS 7.0.
applicationHost.config представляет собой текстовый XML-файл, который можно открыть в любом стандартном текстовом редакторе, таком как Блокнот. applicationHost.config is an XML text file that can be opened with any standard text editor (such as Notepad). Однако предпочтительным способом добавления привязок сайта, отличных от HTTP, является средство настройки командной строки IIS 7,0 (appcmd.exe). However, the IIS 7.0 command-line configuration tool (appcmd.exe) is the preferred way to add non-HTTP site bindings.
Следующая команда добавляет в веб-узел по умолчанию привязку узла к протоколу net.tcp с помощью команды appcmd.exe (вводится как одна строка). The following command adds a net.tcp site binding to the default Web site using appcmd.exe (this command is entered as a single line).
Эта команда добавляет новую привязку net.tcp в веб-узел по умолчанию путем добавления приведенной ниже строки в файл applicationHost.config. This command adds the new net.tcp binding to the default Web site by adding the line indicated below to the applicationHost.config file.
Разрешение приложению использовать протоколы, отличные от HTTP Enabling an Application to Use Non-HTTP Protocols
Вы можете включить или отключить отдельную сеть, протоколсат уровень приложения. You can enable or disable individual network protocolsat the application level. Следующая команда иллюстрирует включение и протокола HTTP, и протокола net.tcp для приложения, выполняющегося на сайте Default Web Site . The following command illustrates how to enable both the HTTP and net.tcp protocols for an application that runs in the Default Web Site .
Следующий XML-код из файла applicationHost.config иллюстрирует сайт, привязанный и к протоколу HTTP, и к протоколу, отличному от HTTP. The following XML code from applicationHost.config illustrates a site bound to both HTTP and non-HTTP protocols. Дополнительная конфигурация, необходимая для поддержки отличных от HTTP протоколов, выделена комментариями. The additional configuration required to support non-HTTP protocols is called out with comments.
При попытке запустить службу с помощью WAS для активации по протоколу, отличному от HTTP, когда службы WAS не установлены и не настроены, может появиться сообщение об ошибке: If you attempt to activate a service using WAS for Non-HTTP activation and you have not installed and configured WAS you may see the following error:
Если появилось это сообщение об ошибке, убедитесь, что установлены и правильно настроены службы WAS для активации по протоколу, отличному от HTTP. If you see this error ensure WAS for Non-HTTP Activation is installed and configured properly. Дополнительные сведения см. в разделе инструкции. Установка и настройка компонентов активации WCF. For more information, see How to: Install and Configure WCF Activation Components.
Построение службы WCF, использующей WAS для активации по протоколу, отличному от HTTP Building a WCF Service That Uses WAS for Non-HTTP activation
После выполнения действий по установке и настройке WAS (см. раздел как установить и настроить компоненты активации WCF) Настройка службы для использования была выполнена для активации аналогично настройке службы, размещенной в службах IIS. Once you perform the steps to install and configure WAS (see How to: Install and Configure WCF Activation Components), configuring a service to use WAS for activation is similar to configuring a service that is hosted in IIS.
Подробные инструкции по созданию активированной службы WCF см. в разделе как разместить службу WCF в WAS. For detailed instructions about building a WAS-activated WCF service, see How to: Host a WCF Service in WAS.
Учебник. Создание клиента Windows Communication Foundation Tutorial: Create a Windows Communication Foundation client
В этом руководстве описываются четвертые из пяти задач, необходимых для создания базового приложения Windows Communication Foundation (WCF). This tutorial describes the fourth of five tasks required to create a basic Windows Communication Foundation (WCF) application. Общие сведения о учебниках см. в разделе учебник. Начало работы с Windows Communication Foundation приложениями. For an overview of the tutorials, see Tutorial: Get started with Windows Communication Foundation applications.
Следующей задачей для создания приложения WCF является создание клиента путем извлечения метаданных из службы WCF. The next task for creating a WCF application is to create a client by retrieving metadata from a WCF service. Для добавления ссылки на службу, которая получает метаданные из конечной точки обмена метаданными службы, используется Visual Studio. You use Visual Studio to add a service reference, which gets the metadata from the service’s MEX endpoint. Затем Visual Studio создает управляемый файл исходного кода для прокси клиента на выбранном языке. Visual Studio then generates a managed source code file for a client proxy in the language you’ve chosen. Он также создает файл конфигурации клиента (App.config). It also creates a client configuration file (App.config). Этот файл позволяет клиентскому приложению подключаться к службе в конечной точке. This file enables the client application to connect to the service at an endpoint.
При вызове службы WCF из проекта библиотеки классов в Visual Studio используйте функцию Добавление ссылки на службу для автоматического создания прокси-сервера и связанного файла конфигурации. If you call a WCF service from a class library project in Visual Studio, use the Add Service Reference feature to automatically generate a proxy and associated configuration file. Однако, поскольку проекты библиотеки классов не используют этот файл конфигурации, необходимо добавить параметры в созданный файл конфигурации в файл App.config для исполняемого файла, вызывающего библиотеку классов. However, because class library projects don’t use this configuration file, you need to add the settings in the generated configuration file to the App.config file for the executable that calls the class library.
В качестве альтернативы для создания прокси-класса и файла конфигурации вместо Visual Studio следует использовать средство служебной программы для метаданных ServiceModel . As an alternative, use the ServiceModel Metadata Utility tool instead of Visual Studio to generate the proxy class and configuration file.
Клиентское приложение использует созданный прокси-класс для взаимодействия со службой. The client application uses the generated proxy class to communicate with the service. Эта процедура описана в разделе учебник. Использование клиента. This procedure is described in Tutorial: Use a client.
В этом руководстве вы узнаете, как: In this tutorial, you learn how to:
- Создание и Настройка проекта консольного приложения для клиента WCF. Create and configure a console app project for the WCF client.
- Добавьте ссылку на службу WCF для создания прокси-класса и файлов конфигурации. Add a service reference to the WCF service to generate the proxy class and configuration files.
Создание клиента Windows Communication Foundation Create a Windows Communication Foundation client
Создание проекта консольного приложения в Visual Studio: Create a console app project in Visual Studio:
В меню файл выберите команду Открыть > проект или решение и перейдите к созданному ранее решению GettingStarted (GettingStarted. sln). From the File menu, select Open > Project/Solution and browse to the GettingStarted solution you previously created (GettingStarted.sln). Щелкните Open(Открыть). Select Open.
В меню вид выберите Обозреватель решений. From the View menu, select Solution Explorer.
В окне Обозреватель решений выберите решение GettingStarted (верхний узел), а затем в контекстном меню выберите добавить > Новый проект . In the Solution Explorer window, select the GettingStarted solution (top node), and then select Add > New Project from the shortcut menu.
В левой части окна Добавление нового проекта выберите категорию Рабочий стол Windows в разделе Visual C# или Visual Basic. In the Add New Project window, on the left side, select the Windows Desktop category under Visual C# or Visual Basic.
Выберите шаблон консольное приложение (.NET Framework) и введите GettingStartedClient в поле имя. Select the Console App (.NET Framework) template, and enter GettingStartedClient for the Name. Щелкните ОК. Select OK.
Добавьте ссылку в проект GettingStartedClient в System.ServiceModel сборку: Add a reference in the GettingStartedClient project to the System.ServiceModel assembly:
В окне Обозреватель решений выберите папку References в проекте GettingStartedClient , а затем в контекстном меню выберите пункт Добавить ссылку . In the Solution Explorer window, select the References folder under the GettingStartedClient project, and then select Add Reference from the shortcut menu.
В окне Добавление ссылки в разделе сборки в левой части окна выберите платформа. In the Add Reference window, under Assemblies on the left side of the window, select Framework.
Найдите и выберите System. ServiceModel, а затем нажмите кнопку ОК. Find and select System.ServiceModel, and then choose OK.
Сохраните решение, выбрав файл > сохранить все. Save the solution by selecting File > Save All.
Добавьте ссылку на службу в службу калькулятора: Add a service reference to the calculator service:
В окне Обозреватель решений выберите папку References в проекте GettingStartedClient , а затем в контекстном меню выберите Добавление ссылки на службу . In the Solution Explorer window, select the References folder under the GettingStartedClient project, and then select Add Service Reference from the shortcut menu.
В окне Добавление ссылки на службу выберите Обнаружение. In the Add Service Reference window, select Discover.
Служба CalculatorService запускается, и Visual Studio отображает ее в окне службы . The CalculatorService service starts and Visual Studio displays it in the Services box.
Выберите CalculatorService , чтобы развернуть его и отобразить контракты службы, реализованные службой. Select CalculatorService to expand it and display the service contracts implemented by the service. Оставьте пространство имен по умолчанию и нажмите кнопку ОК. Leave the default Namespace and choose OK.
Visual Studio добавит новый элемент в папку подключенные службы проекта GettingStartedClient . Visual Studio adds a new item under the Connected Services folder in the GettingStartedClient project.
Средство служебной программы метаданных ServiceModel ServiceModel Metadata Utility tool
В следующих примерах показано, как при необходимости использовать средство служебной программы метаданных ServiceModel (Svcutil.exe) для создания файла прокси-класса. The following examples show how to optionally use the ServiceModel Metadata Utility tool (Svcutil.exe) to generate the proxy class file. Это средство создает файл прокси-класса и файл App.config . This tool generates the proxy class file and the App.config file. В следующих примерах показано, как создать прокси-сервер в C# и Visual Basic соответственно: The following examples show how to generate the proxy in C# and Visual Basic, respectively:
Файл конфигурации клиента Client configuration file
После создания клиента Visual Studio создаст файл конфигурации App.config в проекте GettingStartedClient , который должен быть похож на следующий пример: After you’ve created the client, Visual Studio creates the App.config configuration file in the GettingStartedClient project, which should be similar to the following example:
В разделе Обратите внимание на элемент. Under the section, notice the element. Элемент ** ** определяет конечную точку, которую клиент использует для доступа к службе следующим образом: The element defines the endpoint that the client uses to access the service as follows:
- Адрес: http://localhost:8000/GettingStarted/CalculatorService . Address: http://localhost:8000/GettingStarted/CalculatorService . Адрес конечной точки. The address of the endpoint.
- Контракт службы: ServiceReference1.ICalculator . Service contract: ServiceReference1.ICalculator . Контракт службы обрабатывает взаимодействие между клиентом WCF и службой. The service contract handles communication between the WCF client and the service. Visual Studio создала этот контракт при использовании функции Добавление ссылки на службу . Visual Studio generated this contract when you used its Add Service Reference function. По сути, это копия контракта, определенного в проекте Жеттингстартедлиб. It’s essentially a copy of the contract that you defined in the GettingStartedLib project.
- Привязка: WSHttpBinding . Binding: WSHttpBinding. Привязка указывает HTTP как транспорт, взаимодействующую безопасность и другие сведения о конфигурации. The binding specifies HTTP as the transport, interoperable security, and other configuration details.
Дальнейшие действия Next steps
В этом руководстве вы узнали, как выполнять следующие задачи: In this tutorial, you learned how to:
- Создание и Настройка проекта консольного приложения для клиента WCF. Create and configure a console app project for the WCF client.
- Добавьте ссылку на службу WCF, чтобы создать класс прокси и файлы конфигурации для клиентского приложения. Add a service reference to the WCF service to generate the proxy class and configuration files for the client application.
Перейдите к следующему руководству, чтобы узнать, как использовать созданный клиент. Advance to the next tutorial to learn how to use the generated client.