ASP.NET Web Services (ASMX) Tutorial with Examples

🔥 Beginner to Advanced Guide with Examples, Diagrams & Code

ASP.NET Web Services Tutorial: In modern web development, applications often need to communicate with external systems such as payment gateways, weather APIs, or news feeds. Instead of building everything from scratch, developers can reuse existing services. ASP.NET Web Services (ASMX) provide a simple way to expose and consume business logic over the internet using standard protocols like HTTP and XML.

---

📌 What Are ASP.NET Web Services?

Web Services are software components that allow applications to communicate over a network. They enable interoperability between different platforms and programming languages.

• Platform independent
• Language independent
• Uses XML-based communication
• Accessible via HTTP

---

📊 ASP.NET Web Services Architecture Diagram

The diagram above shows how a client sends a request to a web service, which processes it and returns a response.

---

⚙️ How ASP.NET Web Services Work

1. Client sends request (SOAP/XML)
2. Server processes request
3. Response returned in XML format

---

🛠️ Creating an ASP.NET Web Services Application

Step 1: Create Project

Open Visual Studio → Create ASP.NET Web Service Application → Select .NET Framework.

Step 2: Sample Code

[WebMethod]
public int AddNumbers(int a, int b)
{
    return a + b;
}

---

🏷️ Important Attributes

• WebService – Defines service metadata
• WebMethod – Exposes method
• WebServiceBinding – Protocol standard
• ScriptService – Enables AJAX calls

---

⚠️ Method Overloading Limitation

Web Services do not support method overloading directly.

[WebMethod(MessageName = "AddFloat")]
public float AddNumbers(float a, float b)
{
    return a + b;
}

---

🧪 Testing Web Service

Run the project and open:

http://localhost/MyService.asmx

You will see available methods and WSDL document.

---

📄 WSDL in ASP.NET Web Services Explained

WSDL is an XML-based document that describes the web service methods, parameters, and communication format.

---

🌍 Hosting on IIS

1. Open IIS Manager
2. Add Application
3. Set physical path
4. Configure default document

---

🔌 Consuming Web Service in C#

var client = new MyServiceSoapClient();
int result = client.AddNumbers(10, 20);

---

🌐 Calling Web Service Using AJAX

$.ajax({
    type: "POST",
    url: "MyService.asmx/AddNumbers",
    data: JSON.stringify({ a: 5, b: 10 }),
    contentType: "application/json",
    success: function(response) {
        console.log(response.d);
    }
});

---

📡 SOAP XML Example

<soap:Envelope>
  <soap:Body>
    <AddNumbers>
      <a>5</a>
      <b>10</b>
    </AddNumbers>
  </soap:Body>
</soap:Envelope>

---

❌ Limitations

• Heavy XML format
• Slower than REST APIs
• Outdated technology

---

🚀 Modern Alternatives

• ASP.NET Web API
• REST APIs
• gRPC

---

This ASP.NET Web Services Tutorial helps beginners understand how SOAP-based services work in real-world applications.

🏁 Conclusion

ASP.NET Web Services (ASMX) are a foundational technology for distributed systems. While modern APIs have replaced them in many scenarios, they are still useful for legacy systems and understanding service-based architecture.

---

👉 Learn more: ASP.NET Core Tutorial

📖 Official Microsoft Docs:

ASP.NET Web Services Documentation

🔎 Tags

asp.net web services, asmx tutorial, soap vs rest, wsdl explained, web service example c#