System.ServiceModel 4.0.0.0 System.ServiceModel.Configuration.BehaviorExtensionElement

If you set the property to true programmatically, you can 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.

Returning managed exception information to services can be a security risk. This is because exception details expose information about the internal client implementation that could be used by unauthorized 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, you must:

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.

Represents a configuration element that specifies debugging and help information features for a indigo1 service. This class cannot be inherited.

- Constructor
  4.0.0.0
  To be added.

  Initializes a new instance of the class.

- Property
  4.0.0.0
  System.Type To be added. To be added.

  Gets the type of this behavior element.

- Method
  4.0.0.0
  System.Object To be added. To be added. To be added.
- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("httpHelpPageBinding", DefaultValue=Mono.Cecil.CustomAttributeArgument)
  System.Configuration.StringValidator(MinLength=0)
  System.String To be added.

  If this property is not set, the default binding (HttpTransportBindingElement) is used for service help page access as appropriate.

  Gets or sets a string value that specifies the binding to be used when HTTP is utilized to access the service help page.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("httpHelpPageBindingConfiguration", DefaultValue=Mono.Cecil.CustomAttributeArgument)
  System.Configuration.StringValidator(MinLength=0)
  System.String To be added. To be added.

  Gets or sets a string that points to an XML section defining additional configuration information for the binding specified in .

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("httpHelpPageEnabled", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Boolean To be added.

  You can set this 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. In addition, one of the following conditions must also be met:

  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 indicates whether indigo1 publishes an HTML help page at the address specified by the property.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("httpHelpPageUrl", Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Uri To be added.

  You can use this property to enable the use of a custom HTML help file that is returned from an HTTP/Get request, for example, from an HTML browser. The location of the HTML help file is resolved as follows.

  If the value of this property is a relative address, 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, 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 valid only when the property is true.

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

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("httpsHelpPageBinding", DefaultValue=Mono.Cecil.CustomAttributeArgument)
  System.Configuration.StringValidator(MinLength=0)
  System.String To be added.

  If this property is not set, the default binding (HttpsTransportBindingElement) is used for service help page access as appropriate.

  Gets or sets a string value that specifies the binding to be used when HTTPS is utilized to access the service help page.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("httpsHelpPageBindingConfiguration", DefaultValue=Mono.Cecil.CustomAttributeArgument)
  System.Configuration.StringValidator(MinLength=0)
  System.String To be added. To be added.

  Gets or sets a string that points to an XML section defining additional configuration information for the binding specified in .

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("httpsHelpPageEnabled", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Boolean To be added.

  You can set this 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. In addition, one of the following conditions must also be met:

  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 specified by the property.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("httpsHelpPageUrl", Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Uri To be added.

  You can use this property to enable the use of a custom HTML help file that is returned from an HTTPS/Get request, for example, from an HTML browser. The location of the HTML help file is resolved as follows.

  If the value of this property is a relative address, 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, 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 valid only when the property is true.

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

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("includeExceptionDetailInFaults", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Boolean To be added.

  If you set the property to true programmatically, you can 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.

  Returning managed exception information to services can be a security risk. This is because exception details expose information about the internal client implementation that could be used by unauthorized 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.

- Property
  4.0.0.0
  System.Configuration.ConfigurationPropertyCollection To be added. To be added. To be added.