SoapDocumentServiceAttribute.Use SoapDocumentServiceAttribute.Use SoapDocumentServiceAttribute.Use SoapDocumentServiceAttribute.Use Property

Definition

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

public:
 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.

Examples

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

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

	[SoapDocumentService(SoapBindingUse.Literal,
		                 SoapParameterStyle.Wrapped)]
	public class SumService : System.Web.Services.WebService
	{
		[WebMethod]
		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

Remarks

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