<?xml version="1.0" encoding="utf-8"?> <Type Name="SoapDocumentServiceAttribute" FullName="System.Web.Services.Protocols.SoapDocumentServiceAttribute"> <TypeSignature Language="C#" Maintainer="auto" Value="public sealed class SoapDocumentServiceAttribute : Attribute" /> <AssemblyInfo> <AssemblyName>System.Web.Services</AssemblyName> <AssemblyPublicKey> </AssemblyPublicKey> <AssemblyVersion>1.0.5000.0</AssemblyVersion> <AssemblyVersion>2.0.0.0</AssemblyVersion> </AssemblyInfo> <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement> <Base> <BaseTypeName>System.Attribute</BaseTypeName> </Base> <Interfaces /> <Attributes> <Attribute> <AttributeName>System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)</AttributeName> </Attribute> </Attributes> <Docs> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="T:System.Web.Services.Protocols.SoapDocumentServiceAttribute" /> allows you to set the default formatting styles for XML Web service methods within an XML Web service. If an individual XML Web service method must change these defaults, apply a <see cref="T:System.Web.Services.Protocols.SoapDocumentMethodAttribute" /> to that XML Web service method.</para> <para>Web Services Description Language (WSDL) defines two styles for how an XML Web service method, which it calls an operation, can be formatted in a SOAP request or a SOAP response: RPC and Document. Exactly how the individual message parts is determined by the <see cref="P:System.Web.Services.Protocols.SoapDocumentServiceAttribute.Use" /> and <see cref="P:System.Web.Services.Protocols.SoapDocumentServiceAttribute.ParameterStyle" /> properties. The <see cref="P:System.Web.Services.Protocols.SoapDocumentServiceAttribute.Use" /> property determines whether parameters are formatted Encoded or Literal. The <see cref="P:System.Web.Services.Protocols.SoapDocumentServiceAttribute.ParameterStyle" /> determines whether the parameters are encapsulated within a single message part beneath the Body element, or whether each parameter is an individual message part.</para> <para>To set the default method level formatting to RPC, apply a <see cref="T:System.Web.Services.Protocols.SoapRpcServiceAttribute" /> to the class implementing the XML Web service.</para> <para>For more details, see <format type="text/html"><a href="1D777288-C0D9-4E6A-B638-F010DA031952">[<topic://cpconCustomizingSOAPInASPNETWebServicesWebServiceClients>]</a></format>.</para> <para>This attribute can be applied to a class implementing an XML Web service.</para> </remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Applying the optional <see cref="T:System.Web.Services.Protocols.SoapDocumentServiceAttribute" /> to an XML Web service sets the default format of SOAP requests and responses sent to and from XML Web service methods within the XML Web service.</para> </summary> </Docs> <Members> <Member MemberName=".ctor"> <MemberSignature Language="C#" Value="public SoapDocumentServiceAttribute ();" /> <MemberType>Constructor</MemberType> <ReturnValue /> <Parameters /> <Docs> <remarks>To be added</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Initializes a new instance of the <see cref="T:System.Web.Services.Protocols.SoapDocumentServiceAttribute" /> class setting all properties to their default values.</para> </summary> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> <AssemblyVersion>2.0.0.0</AssemblyVersion> </AssemblyInfo> </Member> <Member MemberName=".ctor"> <MemberSignature Language="C#" Value="public SoapDocumentServiceAttribute (System.Web.Services.Description.SoapBindingUse use);" /> <MemberType>Constructor</MemberType> <ReturnValue /> <Parameters> <Parameter Name="use" Type="System.Web.Services.Description.SoapBindingUse" /> </Parameters> <Docs> <remarks>To be added</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Initializes a new instance of the <see cref="T:System.Web.Services.Protocols.SoapDocumentServiceAttribute" /> class setting the parameter formatting.</para> </summary> <param name="use"> <attribution license="cc4" from="Microsoft" modified="false" />The parameter formatting of the XML Web service. Sets the <see cref="P:System.Web.Services.Protocols.SoapDocumentServiceAttribute.Use" /> property. </param> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> <AssemblyVersion>2.0.0.0</AssemblyVersion> </AssemblyInfo> </Member> <Member MemberName=".ctor"> <MemberSignature Language="C#" Value="public SoapDocumentServiceAttribute (System.Web.Services.Description.SoapBindingUse use, System.Web.Services.Protocols.SoapParameterStyle paramStyle);" /> <MemberType>Constructor</MemberType> <ReturnValue /> <Parameters> <Parameter Name="use" Type="System.Web.Services.Description.SoapBindingUse" /> <Parameter Name="paramStyle" Type="System.Web.Services.Protocols.SoapParameterStyle" /> </Parameters> <Docs> <remarks>To be added</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Initializes a new instance of the <see cref="T:System.Web.Services.Protocols.SoapDocumentServiceAttribute" /> class that sets the parameter formatting and sets whether parameters are encapsulated within a single XML element, under the Body element, in SOAP messages.</para> </summary> <param name="use"> <attribution license="cc4" from="Microsoft" modified="false" />The parameter formatting style. Sets the <see cref="P:System.Web.Services.Protocols.SoapDocumentServiceAttribute.Use" /> property. </param> <param name="paramStyle"> <attribution license="cc4" from="Microsoft" modified="false" />Sets whether parameters are encapsulated within a single XML element, under the Body element, in SOAP messages sent to and from XML Web service methods within the XML Web service. Sets the <see cref="P:System.Web.Services.Protocols.SoapDocumentServiceAttribute.ParameterStyle" /> property. </param> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> <AssemblyVersion>2.0.0.0</AssemblyVersion> </AssemblyInfo> </Member> <Member MemberName="ParameterStyle"> <MemberSignature Language="C#" Value="public System.Web.Services.Protocols.SoapParameterStyle ParameterStyle { set; get; }" /> <MemberType>Property</MemberType> <ReturnValue> <ReturnType>System.Web.Services.Protocols.SoapParameterStyle</ReturnType> </ReturnValue> <Parameters /> <Docs> <value>To be added: an object of type 'SoapParameterStyle'</value> <remarks>To be added</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets or sets the default setting that controls whether parameters are encapsulated within a single element following the <Body> element in the XML portion of a SOAP message for XML Web service methods of the XML Web service.</para> </summary> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> <AssemblyVersion>2.0.0.0</AssemblyVersion> </AssemblyInfo> </Member> <Member MemberName="RoutingStyle"> <MemberSignature Language="C#" Value="public System.Web.Services.Protocols.SoapServiceRoutingStyle RoutingStyle { set; get; }" /> <MemberType>Property</MemberType> <ReturnValue> <ReturnType>System.Web.Services.Protocols.SoapServiceRoutingStyle</ReturnType> </ReturnValue> <Parameters /> <Docs> <value>To be added: an object of type 'SoapServiceRoutingStyle'</value> <remarks>To be added</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets or sets how SOAP messages are routed to the XML Web service.</para> </summary> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> <AssemblyVersion>2.0.0.0</AssemblyVersion> </AssemblyInfo> </Member> <Member MemberName="Use"> <MemberSignature Language="C#" Value="public System.Web.Services.Description.SoapBindingUse Use { set; get; }" /> <MemberType>Property</MemberType> <ReturnValue> <ReturnType>System.Web.Services.Description.SoapBindingUse</ReturnType> </ReturnValue> <Parameters /> <Docs> <value>a <see cref="T:System.Web.Services.Description.SoapBindingUse" /></value> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The Web Services Description Language (WSDL) defines two formatting styles for parameters sent to and from XML Web services: <see cref="F:System.Web.Services.Description.SoapBindingUse.Encoded" /> and <see cref="F:System.Web.Services.Description.SoapBindingUse.Literal" />. <see cref="F:System.Web.Services.Description.SoapBindingUse.Encoded" /> refers to formatting the parameters using the SOAP encoding outlined in the SOAP specification in section 5. <see cref="F:System.Web.Services.Description.SoapBindingUse.Literal" /> refers to formatting the parameters using a predefined XSD schema for each parameter.</para> <para>For more details, see <format type="text/html"><a href="1D777288-C0D9-4E6A-B638-F010DA031952">[<topic://cpconCustomizingSOAPInASPNETWebServicesWebServiceClients>]</a></format>.</para> </remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets or sets the default parameter formatting for an XML Web service.</para> </summary> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> <AssemblyVersion>2.0.0.0</AssemblyVersion> </AssemblyInfo> </Member> </Members> </Type>