C#: WS Service Tutorial (WCF) with 2 SOAP Accessible Methods

See video: https://youtu.be/plRPBT3h3S8

Create Project

Add New Project > WCF Service Application

ProtoService

Project Layout

Add WebService

Add New Item > Web Service ( ASMX )

TemperatureConverter.asmx

Update [WebService(Namespace = "https:www.yourhostname.com/")]
A Class file of the same name is created

Project Layout

TemperatureConverter.asmx.cs

Create two methods to convert Faherenheit to Celsius and F to C
Update the WebService Namespace

WebService(Namespace ="")] Annotation

WebMethod Annotation

To Expose the methods publicly, add [WebMethod] annotation above the method names

Class File After Updates

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Services;

namespace ProtoService
{
    /// <summary>
    /// Summary description for TemperatureConverter
    /// </summary>
    [WebService(Namespace = "http://www.unityconstruct.org/")]
    [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
    [System.ComponentModel.ToolboxItem(false)]
    // To allow this Web Service to be called from script, using ASP.NET AJAX, uncomment the following line.
    // [System.Web.Script.Services.ScriptService]
    public class TemperatureConverter : System.Web.Services.WebService
    {
        // annotation for EXPOSING method to the outside world
        [WebMethod]
        public double ConvertFahernheitToCelsius(double Farhenheit)
        {
            double Celsius = (((Farhenheit - 32) * 5) / 9);
            return Celsius;
        }
        [WebMethod]
        public double ConvertCelsiusToFahernheit(double Celsius)
        {
            double Farhenheit = (32 + ((9 * Celsius) / 5));
            return Farhenheit;
        }
    }
}

Run Service

FireFox ( or Chrome ) will start up
Click 'Service Description' link for the wsdl
The two WebService methods will be shown
- ConvertCelsiusToFahernheit
- ConvertFahernheitToCelsius

ConvertCelsiusToFahernheit

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TemperatureConverter.asmx HTTP/1.1
Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.unityconstruct.org/ConvertCelsiusToFahernheit"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ConvertCelsiusToFahernheit xmlns="http://www.unityconstruct.org/">
      <Celsius>double</Celsius>
    </ConvertCelsiusToFahernheit>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ConvertCelsiusToFahernheitResponse xmlns="http://www.unityconstruct.org/">
      <ConvertCelsiusToFahernheitResult>double</ConvertCelsiusToFahernheitResult>
    </ConvertCelsiusToFahernheitResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TemperatureConverter.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <ConvertCelsiusToFahernheit xmlns="http://www.unityconstruct.org/">
      <Celsius>double</Celsius>
    </ConvertCelsiusToFahernheit>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <ConvertCelsiusToFahernheitResponse xmlns="http://www.unityconstruct.org/">
      <ConvertCelsiusToFahernheitResult>double</ConvertCelsiusToFahernheitResult>
    </ConvertCelsiusToFahernheitResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TemperatureConverter.asmx/ConvertCelsiusToFahernheit HTTP/1.1
Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length

Celsius=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<double xmlns="http://www.unityconstruct.org/">double</double>

ConvertFahernheitToCelsius

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TemperatureConverter.asmx HTTP/1.1
Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.unityconstruct.org/ConvertFahernheitToCelsius"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ConvertFahernheitToCelsius xmlns="http://www.unityconstruct.org/">
      <Farhenheit>double</Farhenheit>
    </ConvertFahernheitToCelsius>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ConvertFahernheitToCelsiusResponse xmlns="http://www.unityconstruct.org/">
      <ConvertFahernheitToCelsiusResult>double</ConvertFahernheitToCelsiusResult>
    </ConvertFahernheitToCelsiusResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TemperatureConverter.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <ConvertFahernheitToCelsius xmlns="http://www.unityconstruct.org/">
      <Farhenheit>double</Farhenheit>
    </ConvertFahernheitToCelsius>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <ConvertFahernheitToCelsiusResponse xmlns="http://www.unityconstruct.org/">
      <ConvertFahernheitToCelsiusResult>double</ConvertFahernheitToCelsiusResult>
    </ConvertFahernheitToCelsiusResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TemperatureConverter.asmx/ConvertFahernheitToCelsius HTTP/1.1
Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length

Farhenheit=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<double xmlns="http://www.unityconstruct.org/">double</double>

Change the url/port of the webservice endpoint

Open Project > Properties > Web Project Url

http://localhost:49291

To Allow External Connections to the WebService

Quickly: Was getting HTTP400 and/or HTTP503 errors when attempting to connect remotely.

Turn off Windows Firewall to simplify troubleshooting

if this is the issue NO response will be received & it will timeout
if firewall is fine, then the HTTP 400(Invalid Hostname) and/or HTTP503 (Service not available) might be encountered

Adding urlacl using netsh resolved the HTTP400 error ( WITH firewall disabled )

netsh http add urlacl url=http://*:49294/ user=everyone

this will add the host(s) to the access list so the OS will allow the connection

Updating applicationhost.config to include BOTH resolved the 503 ( WITH firewall disabled )

<binding protocol="http" bindingInformation="*:49294:localhost" /> 
<binding protocol="http" bindingInformation="*:49294:*" />

This will add the host(s) to the IIS WEBSITE whitelist
There were several site "name" elements & only ONE required the 'localhost' machine name, presumably for the automatic firing & connection of a browser when starting the IIS 'website/service'
THIS is the binding that needs the additional "*" entry

More Detail for Allowing External Connections to the WebService

Turn off Windows Firewall (or Linux firewall)

if working, then just add a New Rule for the inbound port#
then Enable firewall & retry

Update applicationhost.config to allow remote ip address access

modify the config here:
$(solutionDir)\.vs\config\applicationhost.config

or here:

%userprofile%\Documents\IISExpress\config\applicationhost.config

from

<binding protocol="http" bindingInformation="*:49294:localhost" />

<binding protocol="http" bindingInformation="*:49294:*" />

Alternatively, one can also add an additional binding for a specific machine

<binding protocol="http" bindingInformation="*:49294:192.168.0.101" />

<binding protocol="http" bindingInformation="*:49294:MyComputerHostName" />

Using netsh as LAST RECOURSE

https://stackoverflow.com/questions/5442551/iisexpress-returns-a-503-error-from-remote-machines
This might work in scenarios where the applicationhost.config is setup correctly but WIndowsOS is blocking remote access.
THIS CAN CAUSE OTHER ISSUES SO be sure to know the ADD and DELETE commands for netsh

netsh command

change 49291/49294 to whatever IIS is using

Add

netsh http add urlacl url=http://*:49291/ user=everyone

netsh http add urlacl url=http://*:49294/ user=everyone

Delete

netsh http delete urlacl url=http://*:49291/

netsh http delete urlacl url=http://*:49294/

Import WSDL into SoapUI

Save WDSL provided by the webservice
Import into SoapUI

Generating Test Suites

Soap Project Tree View

Setup Endpoints

Changing hostname/port

Assign endpoint to "All Requests and TestRequests"

Send Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:unit="http://www.unityconstruct.org/">
   <soap:Header/>
   <soap:Body>
      <unit:ConvertCelsiusToFahernheit>
         <unit:Celsius>110</unit:Celsius>
      </unit:ConvertCelsiusToFahernheit>
   </soap:Body>
</soap:Envelope>

Receive Response

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <ConvertCelsiusToFahernheitResponse xmlns="http://www.unityconstruct.org/">
         <ConvertCelsiusToFahernheitResult>230</ConvertCelsiusToFahernheitResult>
      </ConvertCelsiusToFahernheitResponse>
   </soap:Body>
</soap:Envelope>

WSDL Created by WebService

<wsdl:definitions targetNamespace="http://www.unityconstruct.org/">
    <wsdl:types>
        <s:schema elementFormDefault="qualified" targetNamespace="http://www.unityconstruct.org/">
            <s:element name="ConvertFahernheitToCelsius">
                <s:complexType>
                    <s:sequence>
                        <s:element minOccurs="1" maxOccurs="1" name="Farhenheit" type="s:double"/>
                    </s:sequence>
                </s:complexType>
            </s:element>
            <s:element name="ConvertFahernheitToCelsiusResponse">
                <s:complexType>
                    <s:sequence>
                        <s:element minOccurs="1" maxOccurs="1" name="ConvertFahernheitToCelsiusResult" type="s:double"/>
                    </s:sequence>
                </s:complexType>
            </s:element>
            <s:element name="ConvertCelsiusToFahernheit">
                <s:complexType>
                    <s:sequence>
                        <s:element minOccurs="1" maxOccurs="1" name="Celsius" type="s:double"/>
                    </s:sequence>
                </s:complexType>
            </s:element>
            <s:element name="ConvertCelsiusToFahernheitResponse">
                <s:complexType>
                    <s:sequence>
                        <s:element minOccurs="1" maxOccurs="1" name="ConvertCelsiusToFahernheitResult" type="s:double"/>
                    </s:sequence>
                </s:complexType>
            </s:element>
        </s:schema>
    </wsdl:types>
    <wsdl:message name="ConvertFahernheitToCelsiusSoapIn">
        <wsdl:part name="parameters" element="tns:ConvertFahernheitToCelsius"/>
    </wsdl:message>
    <wsdl:message name="ConvertFahernheitToCelsiusSoapOut">
        <wsdl:part name="parameters" element="tns:ConvertFahernheitToCelsiusResponse"/>
    </wsdl:message>
    <wsdl:message name="ConvertCelsiusToFahernheitSoapIn">
        <wsdl:part name="parameters" element="tns:ConvertCelsiusToFahernheit"/>
    </wsdl:message>
    <wsdl:message name="ConvertCelsiusToFahernheitSoapOut">
        <wsdl:part name="parameters" element="tns:ConvertCelsiusToFahernheitResponse"/>
    </wsdl:message>
    <wsdl:portType name="TemperatureConverterSoap">
        <wsdl:operation name="ConvertFahernheitToCelsius">
            <wsdl:input message="tns:ConvertFahernheitToCelsiusSoapIn"/>
            <wsdl:output message="tns:ConvertFahernheitToCelsiusSoapOut"/>
        </wsdl:operation>
        <wsdl:operation name="ConvertCelsiusToFahernheit">
            <wsdl:input message="tns:ConvertCelsiusToFahernheitSoapIn"/>
            <wsdl:output message="tns:ConvertCelsiusToFahernheitSoapOut"/>
        </wsdl:operation>
    </wsdl:portType>
    <wsdl:binding name="TemperatureConverterSoap" type="tns:TemperatureConverterSoap">
        <soap:binding transport="http://schemas.xmlsoap.org/soap/http"/>
        <wsdl:operation name="ConvertFahernheitToCelsius">
            <soap:operation soapAction="http://www.unityconstruct.org/ConvertFahernheitToCelsius" style="document"/>
            <wsdl:input>
                <soap:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap:body use="literal"/>
            </wsdl:output>
        </wsdl:operation>
        <wsdl:operation name="ConvertCelsiusToFahernheit">
            <soap:operation soapAction="http://www.unityconstruct.org/ConvertCelsiusToFahernheit" style="document"/>
            <wsdl:input>
                <soap:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap:body use="literal"/>
            </wsdl:output>
        </wsdl:operation>
    </wsdl:binding>
    <wsdl:binding name="TemperatureConverterSoap12" type="tns:TemperatureConverterSoap">
        <soap12:binding transport="http://schemas.xmlsoap.org/soap/http"/>
        <wsdl:operation name="ConvertFahernheitToCelsius">
            <soap12:operation soapAction="http://www.unityconstruct.org/ConvertFahernheitToCelsius" style="document"/>
            <wsdl:input>
                <soap12:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap12:body use="literal"/>
            </wsdl:output>
        </wsdl:operation>
        <wsdl:operation name="ConvertCelsiusToFahernheit">
            <soap12:operation soapAction="http://www.unityconstruct.org/ConvertCelsiusToFahernheit" style="document"/>
            <wsdl:input>
                <soap12:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap12:body use="literal"/>
            </wsdl:output>
        </wsdl:operation>
    </wsdl:binding>
    <wsdl:service name="TemperatureConverter">
        <wsdl:port name="TemperatureConverterSoap" binding="tns:TemperatureConverterSoap">
            <soap:address location="http://localhost:49294/TemperatureConverter.asmx"/>
        </wsdl:port>
        <wsdl:port name="TemperatureConverterSoap12" binding="tns:TemperatureConverterSoap12">
            <soap12:address location="http://localhost:49294/TemperatureConverter.asmx"/>
        </wsdl:port>
    </wsdl:service>
</wsdl:definitions>

Parameter	Value
Celsius:

Parameter	Value
Farhenheit:

C#: WS Service Tutorial (WCF) with 2 SOAP Accessible Methods

Create Project

Project Layout

Add WebService

Project Layout

TemperatureConverter.asmx.cs

WebService(Namespace ="")] Annotation

WebMethod Annotation

Class File After Updates

Run Service

ConvertCelsiusToFahernheit

Test

SOAP 1.1

SOAP 1.2

HTTP POST

ConvertFahernheitToCelsius

Test

SOAP 1.1

SOAP 1.2

HTTP POST

Change the url/port of the webservice endpoint

To Allow External Connections to the WebService

Turn off Windows Firewall to simplify troubleshooting

Adding urlacl using netsh resolved the HTTP400 error ( WITH firewall disabled )

Updating applicationhost.config to include BOTH resolved the 503 ( WITH firewall disabled )

More Detail for Allowing External Connections to the WebService

Turn off Windows Firewall (or Linux firewall)

Update applicationhost.config to allow remote ip address access

Alternatively, one can also add an additional binding for a specific machine

Using netsh as LAST RECOURSE

netsh command

Import WSDL into SoapUI

WSDL Created by WebService

Search

C#: WS Service Tutorial (WCF) with 2 SOAP Accessible Methods