CA2212: Do not mark serviced components with WebMethod

TypeName

DoNotMarkServicedComponentsWithWebMethod

CheckId

CA2212

Category

Microsoft.Usage

Breaking Change

Breaking

Cause

A method in a type that inherits from ServicedComponent is marked with WebMethodAttribute.

Rule Description

WebMethodAttribute applies to methods within an XML Web service that were created by using ASP.NET; it makes the method callable from remote Web clients. The method and class must be public and executing in an ASP.NET Web application. ServicedComponent types are hosted by COM+ applications and can use COM+ services. WebMethodAttribute is not applied to ServicedComponent types because they are not intended for the same scenarios. Specifically, adding the attribute to the ServicedComponent method does not make the method callable from remote Web clients. Because WebMethodAttribute and a ServicedComponent method have conflicting behaviors and requirements for context and transaction flow, the behavior of the method will be incorrect in some scenarios.

How to Fix Violations

To fix a violation of this rule, remove the attribute from the ServicedComponent method.

When to Suppress Warnings

Do not suppress a warning from this rule. There are no scenarios where combining these elements is correct.

See Also

Reference

ServicedComponent

WebMethodAttribute