This topic applies to the following types of presentation projects:
WCF Service Application using Scaffolding. Refer to Creating a WCF Service Application using Scaffolding.
WCF Service Application. Refer to Creating a WCF Service Application.
WCF ASP.Net Compatibility Service Application. Refer to Creating a WCF ASP.Net Compatibility Service Application.
To test a Web API RESTful Service Application, refer to the topic Testing a Web API RESTful Web Service Application. To test a WCF RESTful Service Application, refer to the topic Testing a WCF RESTful Web Service Application.
Testing using the Microsoft WCF Test Client
You can test your Web service application using the built-in WCF Test Client program which Microsoft supplies with Visual Studio.
Procedure 1 – Testing Under the Debugger
In Solution Explorer, right-click the presentation project, and click Set as StartUp Project.
If your presentation project is a WCF Project using Scaffolding, in Solution Explorer, double-click on the .svc file in the root of the project to open the service code file.
On the Debug menu, click Start Debugging. Visual Studio automatically starts a copy of IIS Express to host your application and runs the Microsoft WCF Test Client application.
If your project requires a session, you must perform the following steps in the test client.
Right click on Config File and select Edit With SvcConfigEditor.
In the SvcConfigEditor editor, expand the Bindings folder and select the binding.
Set AllowCookies to true.
Save the settings and close the editor.
If you are prompted to reload the test client, click Yes.
If the Microsoft WCF Test Client does not launch, perform the following steps.
In project properties, click the Web tab.
Set the Start external program with the following:
For 32-bit Windows operating systems,
C:\Program Files\Microsoft Visual Studio\2019\<VS Edition>\Common7\IDE \WcfTestClient.exe
Where, <VS Edition> is the Visual Studio edition and it can be any of the following: Professional, Community, or Enterprise.
For 64-bit Windows operating systems,
C:\Program Files (x86)\Microsoft Visual Studio\2019\<VS Edition>\Common7\IDE \WcfTestClient.exe
Where, <VS Edition> is the Visual Studio edition and it can be any of the following: Professional, Community, or Enterprise.
Notes:
If WcfTestClient.exe is not available in the preceeding location, do any one of the following to install the WcfTestClient.exe:
If you are installing the Visual Studio Installer for the first time, launch Visual Studio Installer and on the Individual components tab, under Development activities, select the Windows Communication Foundation check box.
If you have installed Visual Studio Installer previously, launch Visual Studio Installer and under the Installed tab, click Modify. Select the Individual components tab, and under Development activities, select the Windows Communication Foundation check box.
The Command line arguments are http://localhost:<port>/Service.svc where <port> is the port number specified in Specific Port.
Set the working directory to the full path of your project, for example C:\Users\<username>\Documents\Visual Studio 2019\Projects\MySolution\WcfService1\.
If you encounter unexpected errors during your testing, refer to the Troubleshooting section of this help file.
Procedure 2 – Stopping the Debugger
On the Debug menu, click Stop Debugging.
In the Windows system tray (at the right end of your Taskbar), right-click the icon for IIS Express and click Exit. If there are multiple copies of IIS Express running, be sure to stop each one.
Procedure 3 – Testing After Deployment
After you deploy to the ePortal platform, perform the following steps to test a Web Service application that is not a RESTful Web Service application:
Start the Microsoft WCF Test Client. You do not need to be running Visual Studio; simply run WcfTestClient.exe. By default, it is found in the directory C:\Program Files\Microsoft Visual Studio\2019\<VS Edition>\Common7\IDE (for 32-bit Windows) or C:\Program Files (x86)\Microsoft Visual Studio\2019\<VS Edition>\Common7\IDE (for 64-bit Windows).
Where, <VS Edition> is the Visual Studio edition and it can be any of the following: Professional, Community, or Enterprise.
In the test client, select File and then select Add Service....
In the Add Service dialog, enter the URL of the web service to be tested. By default, this URL is of the form http://ep-vs-adress/servicename/Service.svc, where ep-vs-adress is the IP address or DNS name of the ePortal Web Cluster and servicename is the Deployed As name for the web service application.
If your project requires a session, you must perform the following steps in the test client:
Right click on Config File and select Edit With SvcConfigEditor.
In the SvcConfigEditor editor, expand the Bindings folder and select the binding.
Set AllowCookies to true.
Save the settings and close the editor.
If you are prompted to reload the test client, select Yes.
When you are done testing, select File and then select Exit.