SoapDocumentServiceAttribute.Use Property


Gets or sets the default parameter formatting for an XML Web service.

 property System::Web::Services::Description::SoapBindingUse Use { System::Web::Services::Description::SoapBindingUse get(); void set(System::Web::Services::Description::SoapBindingUse value); };
public System.Web.Services.Description.SoapBindingUse Use { get; set; }
member this.Use : System.Web.Services.Description.SoapBindingUse with get, set
Public Property Use As SoapBindingUse

Property Value


The default SoapBindingUse for the XML Web service. If not set, the default is Literal.


<%@ WebService Language="c#" Class="SumService" %>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;

    public class SumService : System.Web.Services.WebService
        public int Add(int a, int b)
            return a + b;
<%@ WebService Language="VB" Class="SumService" %>

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Web.Services.Description

    <SoapDocumentService(SoapBindingUse.Literal, _
                             SoapParameterStyle.Wrapped)> _
    Public Class SumService 
          Inherits System.Web.Services.WebService
        <WebMethod> _
        Public Function Add(a As Integer, b as Integer)
           return a + b
        End Function
    End Class


The Web Services Description Language (WSDL) defines two formatting styles for parameters sent to and from XML Web services: Encoded and Literal. Encoded refers to formatting the parameters using the SOAP encoding outlined in the SOAP specification in section 5. Literal refers to formatting the parameters using a predefined XSD schema for each parameter.

For more details, see Customizing SOAP Message Formatting.

Applies to

See also