Building the C# Sample Programs

The vSphere Web Services SDK contains sample clients that demonstrate how to perform functions to manage your datacenter. The samples are organized into individual Visual Studio projects, which are collected in a single solution file. This document explains how to build the entire solution set.

Build the C# Sample Programs

The C# sample clients demonstrate functions that you can use to manage your datacenter. The build process varies, depending on the version of Visual Studio. The process is illustrated in Build Process for C# Sample Programs and described in To build the C# sample programs.

Build Process for C# Sample Programs

Prerequisites for Building the C# Sample Programs

Before you build a sample program, you must build the relevant DLLs:

■	STSService.dll

■	Vim25Service.dll

■	Vim25Service.XmlSerializers.dll

See Build the C# vSphere DLLs and Build the C# SSO DLL for information about building the DLLs.

To build the C# sample programs

1	Launch Visual Studio and load the solution file, Samples2008.sln.

The solution file is found in the %SDK_HOME%\vsphere-ws\dotnet\cs\samples directory.

If you are using a version of Visual Studio later than 2008, the Visual Studio Conversion Wizard prompts you to convert the 2008 solution file to the newer version.

■	If you also have Visual Studio 2008, select Yes when the wizard prompts you to save a backup of the original solution file.

■	If you do not have Visual Studio 2008, you do not need to save a backup of the original solution file.

2	If you are using a version of Visual Studio later than 2008, convert each project to use .NET Framework 4.

a	To convert a project to use .NET Framework 4, right-click its name in the Solution Explorer and select Properties.

b	In the Properties panel, change the Target Framework from .NET Framework 3.5 to .NET Framework 4.

3	From the Visual Studio menu, select Build > Build Solution.

All the sample programs build. The Output pane at the bottom of the Visual Studio window shows build errors, if any.

4	Correct any errors in the build, and repeat the build.