Converting a Service from WSRF.NET 2.X to WSRF.NET 3.0

WSRF.NET 3.0 uses the .NET framework version 2.0 and Visual Studio 2005. This means that any web service created with WSRF.NET 2.X (i.e. using .NET 1.1 and Visual Studio 2003) will have to be converted to run on WSRF.NET 3.0. NOTE: the source code for the service does not need to be changed (unless you are using .NET functionality that has changed between framework versions - WSRF.NET uses the same programming model), but the service will need to be rebuilt. To convert a service, take the following steps.

1. Convert your service using VS.NET's conversion tool. Open the service's solution using VS.NET 2005. You will be prompted to convert you solution/project files to VS.NET 2005.
2. Reset the WSRF property VS.NET's conversion system does not preserve the "WSRF" property on .asmx files. Left-click on each .asmx file in your solution and set the "WSRF" property (in the properties window - usually in the lower right hand corner) to "True".
3. Remove WSE2 elements from the service's web.config file. WSRF.NET 3.0 uses WSE3 and so all references to WSE2 configuration in the service's web.config file must be removed. This includes:
  • within the <configuration><configSections> element, remove the element that begins with <section name="microsoft.web.services2"
  • within the <configuration><system.web><webServices><SoapExtensionTypes> element, remove the element that starts with <add type=""Microsoft.Web.Services2.WebServicesExtension"
  • within the <configuration> element, remove any <microsoft.web.services2> element and all sub-elements
4. Setup WSE3.0 Right-click on the project and select "WSE Settings 3.0". Then check both the "Enable this project for web services enhancements" and "Enable Microsoft Web Services Enhancement Soap Protocol Factory" boxes.
5. Remove any old WSRF.NET dlls from the service's bin directory Note: This step assumes you have successfully built WSRF.NET 3.0.    Open the web service's bin directory in VS.NET and remove any WSRF.NET dlls. Add references to the same dlls from WSRF.NET 3.0 (most likely these will be the UVa.GCG.WSRF.Service and UVa.GCG.WSRF.Common dlls).
6. Build you site Build your web site from the VS.NET Build menu. Fix any errors that caused by changes in .NET framework versions (hopefully there will be none).
7. Remove old .generated dlls Go back to the service's bin directory and remove any dlls that end in .generated.dll. These were used by previous versions of WSRF.NET.
8. Build again Build your web site again. The reason for this second build is that the first build uses the .generated.dll files from WSRF.NET 2.X to build its own version of those files. Once the first build is complete, the old .generated.dlls must be removed to prevent multiple symbol definitions. This second build tests whether these newly generated files are working. In other words, if the web site builds, the files have been successfully generated. Now you can test your web site.

Problems? email wasson@virginia.edu