Start Using the WES Generator

You must make sure that your development environment meets the WES Generator prerequisites, including access to an instance of MPS and the service you plan to extend, before you begin. See Prerequisites for Deployment and Deploy the WES Generator for more details.

These sample procedures use the Windows Based Hosting namespace to show how the WES Generator Microsoft Visual Studio add-ins can be used to create a service class.

The WES Generator Visual Studio add-ins include a new project type, MPS WES Project, and a new project template, Well Enabled Service.

Procedure CSFINT.x: To create an MPS WES Project

Open Visual Studio 2005.
On the File Menu, click New Project.
Click MPS WES Project.
Under Templates, select Well Enabled Service.
In the Name box, enter SampleWES, and then click OK.

Now that you have created a sample project, you can add a namespace to it. You must have access to an installation of the The Microsoft Solution for Windows-based Hosting version 4.0 in order to add the Managed Hosting namespace to your project as described in the following procedure. If you have access to a Microsoft Solution for Hosted Messaging and Collaboration version 3.5 environment, try using the Hosted Exchange namespace instead.

Procedure CSFINT.x: To add a namespace to an MPS WES Project

Under Solution Explorer, right-click SampleWES, select Add and then click to select Existing Item.
In the Add Existing Item - Sample WES box, select All Files from the Files of Type menu.
Navigate to WindowsBasedHosting_ns.xml on MPS01, and then click Add.

Now that you have added a namespace to your sample project, you can associate the WES Generator with it.

Procedure CSFINT.x: To associate the WES Generator with your project

In the WindowsBasedHosting_ns.xml Properties pane, click Custom Tool , type WesGenerator, and then click Enter.

Once this is complete, the WES Generator will automatically run any time a change is made or this project is saved. When this happens, the WES Generator will automatically update all the associated files.

You can now expand all of the elements in the Solution Explorer window to verify that the WES Generator updated the project.

You can also right-click your sample project name, SampleWES, in the Solution Explorer and select properties to view the settings on the Well Enabled Service tab.

At this point, you can now compile your project by right-clicking SampleWES and then selecting Build. To verify that the compile worked, look in the bin\debug directory of the project to verify the existence of the SampleWES.dll.