System.ServiceModel 4.0.0.0 System.Object System.ServiceModel.Description.IServiceBehavior

Use the properties from a configuration file or programmatically to enable the flow of managed exception information to the client for debugging purposes as well as the publication of HTML information files for users browsing the service in Web browsers.

Set the property to true to instruct indigo2 to return managed exception information in SOAP faults to clients for debugging purposes.

Returning managed exception information to clients can be a security risk because exception details expose information about the internal service implementation that could be used by unauthorized clients. In addition, although the properties can also be set programmatically, it can be easy to forget to disable when deploying.

Because of the security issues involved, it is strongly recommended that:

You use an application configuration file to set the value of the property to true.

You only do so only in controlled debugging scenarios.

crabout the security issues related to managed exception information, see Specifying and Handling Faults in Contracts and Services.

The and properties instruct the service to publish HTML help files when the service is viewed using an HTML browser.

The and properties control the location of the HTML help page that is viewed.

To enable or disable one of the features using a configuration file:

Add a behaviorConfiguration attribute to the <service> element for your indigo2 service. Endpoint behaviors are configured on <endpoint> elements; service behaviors on <service> elements.

Add to or create a <serviceBehaviors> section and add a <behavior> element to that with the name that matches the behaviorConfiguration attribute value from step 1. Endpoint behaviors are configured using an <endpointBehaviors> element; service behaviors are configured using a <serviceBehaviors> element.

Add a <serviceDebug> element to the <behavior> element from step 2 and enable or disable the various properties appropriate to your scenario.

For a specific example, see the Example section.

Enables debugging and help information features for a indigo1 service.

- Constructor
  4.0.0.0

  The constructor creates a object with the following defaults:

  The property is false.

  The property is true.

  The property is true.

  The property is the base address of the service that supports HTTP requests.

  The is the base address of the service that supports HTTPS requests.

  Initializes a new instance of the class.

- Property
  4.0.0.0
  System.ServiceModel.Channels.Binding To be added. To be added.

  Gets or sets high-level access to the definition of a binding.

- Property
  4.0.0.0
  System.Boolean To be added.

  Set the property to false to disable the publication of an HTML help page visible to HTML browsers.

  To ensure the HTML help page is published at the location controlled by the property, you must set this property to true and then one of the following conditions must also be true:

  The property is an absolute address that supports the HTTP protocol scheme.

  There is a base address for the service that supports the HTTP protocol scheme.

  Although an exception is thrown if an absolute address that does not support the HTTP protocol scheme is assigned to the property, any other scenario in which neither of the preceding criteria is met results in no exception and no HTML help page.

  Gets or sets a value that controls whether indigo1 publishes an HTML help page at the address controlled by the property.

- Property
  4.0.0.0
  System.Uri To be added.

  Use the property to enable the use of a custom HTML help file that is returned from an HTTP/Get request such as that of an HTML browser. The location of the HTML help file is resolved as follows:

  If the value of this property is a relative address, then the location of the HTML help file is the value of the service base address that supports HTTP requests plus this property value.

  If the value of this property is an absolute address and supports HTTP requests, then the location of the HTML help file is the value of this property.

  If the value of this property is absolute but does not support HTTP requests, an exception is thrown.

  This property is applied only in the case that the property is true.

  Gets or sets the location at which the HTML help file is published.

- Property
  4.0.0.0
  System.ServiceModel.Channels.Binding To be added. To be added.

  Gets or sets high-level access to the definition of a binding.

- Property
  4.0.0.0
  System.Boolean To be added.

  Set the property to false to disable the publication of an HTML help page visible to HTML browsers.

  To ensure the HTML help page is published at the location controlled by the property, you must set this property to true and then one of the following conditions must also be true:

  The property is an absolute address that supports the HTTPS protocol scheme.

  There is a base address for the service that supports the HTTPS protocol scheme.

  Although an exception is thrown if an absolute address that does not support the HTTPS protocol scheme is assigned to the property, any other scenario in which neither of the preceding criteria is met results in no exception and no HTML help page.

  Gets or sets a value that specifies whether indigo1 returns an HTML help file over HTTPS at the address controlled by the property.

- Property
  4.0.0.0
  System.Uri To be added.

  Use the property to enable the use of a custom HTML help file that is returned from an HTTPS/Get request such as that of an HTML browser.

  The location of the HTML help file is resolved as follows:

  If the value of this property is a relative address, then the location of the HTML help file is the value of the service base address that supports HTTPS requests plus this property value.

  If the value of this property is an absolute address and supports HTTPS requests, then the location of the HTML help file is the value of this property.

  If the value of this property is absolute but does not support HTTPS requests, an exception is thrown.

  This property is applied only in the case that the property is true.

  Gets or sets the location at which an HTML file is published for retrieval using HTTPS.

- Property
  4.0.0.0
  System.Boolean To be added.

  Set the property to true to instruct indigo2 to return managed exception information to the client in SOAP faults to ease debugging.

  Returning managed exception information to clients can be a security risk because exception details expose information about the internal service implementation that could be used by unauthorized clients. In addition, although the properties can also be set programmatically, it can be easy to forget to disable when deploying.

  Because of the security issues involved, it is strongly recommended that:

  You use an application configuration file to set the value of the property to true.

  You only do so only in controlled debugging scenarios.

  crdefault Specifying and Handling Faults in Contracts and Services.

  Gets or sets a value that specifies whether to include managed exception information in the detail of SOAP faults returned to the client for debugging purposes.

- Method
  4.0.0.0
  System.Void `` `` `` ``

  Modifies the bindings to support the behavior. crdefault the method.

  Implements the method to support the behavior.

  The service description. The service host. The endpoints for the service. The binding parameters that support modifying the bindings.
- Method
  4.0.0.0
  System.Void `` `` To be added.

  Implements the method to support the behavior.

  The service description. The service host.
- Method
  4.0.0.0
  System.Void `` `` To be added.

  Implements the method to support the behavior.

  The service description. The service host.