<detailedErrors> Element

Article
09/15/2006

Controls the level of detail returned when there is a fault generated from the Web service.

<microsoft.web.services2> Element
<diagnostics> Element

<detailedErrors enabled="true|false" />

Attributes and Elements

Attributes

Attribute	Description
enabled	Required attribute. true if detailed stack traces should be sent when a fault is generated in a call to a Web service; otherwise, false.

Child Elements

None

Parent Elements

Element	Description
<diagnostics> Element	Controls the diagnostics settings for the Microsoft Web Services Enhancements.

Remarks

Before adding the <diagnostics> element to a configuration file, you must add the microsoft.web.services2 configuration section handler to the configuration file. For details about adding the microsoft.web.services2 configuration section handler, see <section> Element (WSE for Microsoft .NET).

Use the <detailedErrors> option to specify that the complete stack trace should be sent if a fault is generated during a call to a Web service. This option applies to all calls to a Web service regardless of the underlying protocol. If this value is set, it overrides the ASP.NET <customErrors> value. If the value is not set, then the <customErrors> value is used for calls that are sent using the HTTP protocol only. The default for this option is false. For more information about using WSE diagnostic settings, see Troubleshooting WSE Applications.

Example

The following code example specifies that detailed error messages are returned by WSE.

<configuration>
  <microsoft.web.services2>
    <diagnostics> 
      <detailedErrors enabled="true" />
    </diagnostics>
  </microsoft.web.services2>
</configuration>

Share via