<webServices> Element
Controls the settings of Web services deployed using ASP.NET and of Web service clients running on the .NET Framework.
<webServices>
<protocols>
<add name="protocol name"/>
<remove name="protocol name"/>
<clear/>
</protocols>
<serviceDescriptionFormatExtensionTypes>
<add type="type"/>
<remove type="type"/>
<clear/>
</serviceDescriptionFormatExtensionTypes>
<soapExtensionTypes>
<add type="type" priority="number" group="0|1"/>/>
<remove type="type"/>
<clear/>
</soapExtensionTypes>
<soapExtensionReflectorTypes>
<add type="type" priority="number" group="0|1"/>/>
<remove type="type"/>
<clear/>
</soapExtensionReflectorTypes>
<soapExtensionImporterTypes>
<add type="type" priority="number" group="0|1"/>/>
<remove type="type"/>
<clear/>
</soapExtensionImporterTypes>
<wsdlHelpGenerator href="help generator file"/>
<diagnostics suppressReturningExceptions="true|false" />
</webServices>
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child Elements
| Child Element | Description |
|---|---|
| diagnostics | Specifies whether to return exceptions to the client for debugging purposes. |
| protocols | Specifies the protocols that an ASP.NET Web service can use to receive request data sent from a client and return response data. A protocol can be used to associate request data with a method and its parameters and to associate response data with the method and its return value. |
| serviceDescriptionFormatExtensionTypes | Specifies the service description format extension to run within the scope of the configuration file. |
| soapExtensionTypes | Specifies the SOAP extensions used to inspect or modify the SOAP message during processing on the Web service or client. SOAP extensions augment the functionality of Web services. |
| soapExtensionReflectorTypes | Specifies SOAP extension reflector classes, which extend the service description (WSDL document) generation process. For use with service description format extensions (SDFEs). |
| soapExtensionImporterTypes | Specifies SOAP extension importer classes, which extend the client proxy generation process. For use with service description format extensions (SDFEs). |
| wsdlHelpGenerator | Specifies the Web service Help page (an .aspx file) that is displayed to a browser when the browser navigates directly to an ASMX Web services page. |
Parent Elements
| Element | Description |
|---|---|
| configuration | The root element in every configuration file used by the common language runtime and .NET Framework applications. |
| system.web | Specifies the root element for the ASP.NET configuration section. |
The following example specifies XML Web service configuration settings.
<configuration>
<system.web>
<webServices>
<diagnostics suppressReturningExceptions="false"/>
<protocols>
<add name="HttpGet"/>
<add name="HttpPost"/>
<add name="Documentation"/>
</protocols>
<serviceDescriptionFormatExtensionTypes>
</serviceDescriptionFormatExtensionTypes>
<soapExtensionTypes>
</soapExtensionTypes>
<soapExtensionReflectorTypes>
</soapExtensionReflectorTypes>
<soapExtensionImporterTypes>
</soapExtensionImporterTypes>
<wsdlHelpGenerator href="DefaultSdlHelpGenerator.aspx"/>
</webServices>
</system.web>
</configuration>
Reference
Web Services Settings SchemaOther Resources
ASP.NET Configuration SettingsXML Web Services Created Using ASP.NET and XML Web Service Clients
ASP.NET Configuration