从asmx迁移至ServiceStack：如何为API指定namespace与conformsto属性？

Great question! When migrating your legacy ASMX web services to ServiceStack, let's break down how to replicate those two ASMX attributes in ServiceStack's model:

1. Setting the Equivalent of WebService(Namespace) #

ASMX's Namespace attribute defines the XML namespace for your SOAP messages and WSDL. In ServiceStack, you have two flexible ways to handle this:

Per-DTO Configuration #

ServiceStack uses Data Contract attributes for its request/response DTOs. You can apply the [DataContract] attribute directly to individual DTO classes to set their namespace:

[DataContract(Namespace = "http://ourcustomsite.com/externalServices")]
public class YourRequestDto
{
    [DataMember]
    public string YourProperty { get; set; }
}

[DataContract(Namespace = "http://ourcustomsite.com/externalServices")]
public class YourResponseDto
{
    [DataMember]
    public bool Success { get; set; }
}

Global Configuration #

If you want to apply the same namespace to all your DTOs (matching the service-level namespace from your ASMX service), configure it globally in your AppHost's Configure method:

public override void Configure(Container container)
{
    SetConfig(new HostConfig
    {
        // Sets the default namespace for all SOAP WSDLs and message envelopes
        WsdlServiceNamespace = "http://ourcustomsite.com/externalServices"
    });
}

2. Replicating WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1) #

Good news here—ServiceStack's SOAP endpoints natively comply with WS-I Basic Profile 1.1 out of the box. You don't need to set an explicit attribute or special configuration for this.

The framework automatically handles the required SOAP envelope structure, message formatting, and adherence to the WS-I Basic Profile standards. If you ever need to tweak SOAP-specific behavior (like adjusting envelope formatting), you can modify settings in your AppHost, but for basic compliance, no extra steps are needed.

A quick note: Since ServiceStack is REST-first, these settings primarily affect your SOAP endpoints. REST endpoints don't rely on XML namespaces in the same way ASMX services do.

内容的提问来源于stack exchange，提问作者Nirman