ServiceDebugElement Clase

Referencia

Definición

Espacio de nombres:: System.ServiceModel.Configuration

Ensamblado:: System.ServiceModel.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un elemento de configuración que especifica las características de información de depuración y de ayuda para un servicio de Windows Communication Foundation (WCF). Esta clase no puede heredarse.

public ref class ServiceDebugElement sealed : System::ServiceModel::Configuration::BehaviorExtensionElement

public sealed class ServiceDebugElement : System.ServiceModel.Configuration.BehaviorExtensionElement

type ServiceDebugElement = class
    inherit BehaviorExtensionElement

Public NotInheritable Class ServiceDebugElement
Inherits BehaviorExtensionElement

Herencia: Object

ConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Herencia: Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Ejemplos

El ejemplo de código siguiente muestra cómo utilizar un archivo de configuración para habilitar la característica de página de ayuda HTML y devolver información de excepciones dentro de un error de SOAP al cliente para la depuración (además de habilitar la compatibilidad de los metadatos).

<configuration>
  <system.serviceModel>
    <services>
      <!-- 
        Step 1. Add a behaviorConfiguration attribute
        in the <service> element.
      -->
      <service 
        name="Microsoft.WCF.Documentation.SampleService"
        behaviorConfiguration="metadataAndDebug">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService" />
          </baseAddresses>
        </host>
        <endpoint
          address=""
          binding="wsHttpBinding"
          contract="Microsoft.WCF.Documentation.ISampleService"
        />
        <endpoint
           address="mex"
           binding="mexHttpBinding"
           contract="IMetadataExchange"
        />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <!-- 
          Step 2. Inside a <serviceBehaviors> section, add 
          a name attribute in the <behaviors> element that 
          matches the behaviorConfiguration attribute in the
          <service> element above.
        -->
        <behavior name="metadataAndDebug">
          <serviceMetadata 
            httpGetEnabled="true" 
            httpGetUrl=""
          />
          <!-- 
            Step 3. Add a <serviceDebug> element and 
            modify the various attributes that suit your 
            scenario.
          -->
          <serviceDebug 
            httpHelpPageEnabled="true" 
            includeExceptionDetailInFaults="true"
          />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

Comentarios

Si establece la propiedad IncludeExceptionDetailInFaults en true, puede permitir el flujo de información de excepción administrada al cliente para propósitos de depuración, así como la publicación de archivos de información HTML para usuarios que examinen el servicio en exploradores web.

Precaución

Devolver información de excepción administrada a servicios puede ser un riesgo para la seguridad. Esto es porque los detalles de excepción exponen información acerca de la implementación de cliente interno que podría ser usada por servicios no autorizados.

Las propiedades HttpHelpPageEnabled y HttpsHelpPageEnabled indican al servicio que publique los archivos de ayuda HTML cuando el servicio se ve mediante explorador HTML.

Las propiedades HttpHelpPageUrl y HttpsHelpPageUrl controlan la ubicación de la página de ayuda de HTML que se ve.

Para habilitar o deshabilitar una de las características ServiceDebugElement mediante un archivo de configuración, debe:

Agregue un behaviorConfiguration atributo al elemento de servicio> para el< servicio WCF. (Los comportamientos de los puntos de conexión se configuran en <endpoint> elementos; los comportamientos de servicio en <los elementos de servicio> ).
Agregue o cree una <sección serviceBehaviors> y agregue un <elemento de comportamiento> con el nombre que coincida con el valor de atributo del behaviorConfiguration paso 1. (Los comportamientos de los puntos de conexión se configuran mediante un <elemento endpointBehaviors> ; los comportamientos de servicio se configuran mediante un <elemento serviceBehaviors> .
Agregue un <elemento serviceDebug> al elemento de comportamiento> del< paso 2 y habilite o deshabilite las distintas propiedades adecuadas para su escenario.

Para obtener un ejemplo concreto, consulte la sección Ejemplo.

Constructores

ServiceDebugElement()

Inicializa una nueva instancia de la clase ServiceDebugElement.

Propiedades

BehaviorType	Obtiene el tipo de este elemento de comportamiento.
ConfigurationElementName	Obtiene el nombre de este elemento de configuración. (Heredado de ServiceModelExtensionElement)
CurrentConfiguration	Obtiene una referencia a la instancia de Configuration de nivel superior que representa la jerarquía de configuración a la que pertenece la instancia actual de ConfigurationElement. (Heredado de ConfigurationElement)
ElementInformation	Obtiene un objeto ElementInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationElement. (Heredado de ConfigurationElement)
ElementProperty	Obtiene el objeto ConfigurationElementProperty que representa al propio objeto ConfigurationElement. (Heredado de ConfigurationElement)
EvaluationContext	Obtiene el objeto ContextInformation para el objeto ConfigurationElement. (Heredado de ConfigurationElement)
HasContext	Obtiene un valor que indica si la propiedad CurrentConfiguration es `null`. (Heredado de ConfigurationElement)
HttpHelpPageBinding	Obtiene o establece un valor de cadena que especifica el enlace que se va a utilizar cuando HTTP se utiliza para tener acceso a la página de ayuda del servicio.
HttpHelpPageBindingConfiguration	Obtiene o establece una cadena que señala a una sección de XML que define la información de configuración adicional para el enlace especificada en HttpHelpPageBinding.
HttpHelpPageEnabled	Obtiene o establece un valor que indica si Windows Communication Foundation (WCF) publica una página de ayuda HTML en la dirección especificada por la propiedad HttpHelpPageUrl.
HttpHelpPageUrl	Obtiene o establece la ubicación en la que se publica el archivo de ayuda HTML.
HttpsHelpPageBinding	Obtiene o establece un valor de cadena que especifica el enlace que se va a utilizar cuando HTTPS se utiliza para tener acceso a la página de ayuda del servicio.
HttpsHelpPageBindingConfiguration	Obtiene o establece una cadena que señala a una sección de XML que define la información de configuración adicional para el enlace especificada en HttpsHelpPageBinding.
HttpsHelpPageEnabled	Obtiene o establece un valor que especifica si Windows Communication Foundation (WCF) devuelve un archivo de ayuda HTML mediante HTTPS en la dirección especificada por la propiedad HttpsHelpPageUrl.
HttpsHelpPageUrl	Obtiene o establece la ubicación en la que un archivo de ayuda HTML se publica para la recuperación mediante HTTPS.
IncludeExceptionDetailInFaults	Obtiene o establece un valor que especifica si se debe incluir la información de excepción administrada en el detalle de errores SOAP devueltos al cliente para la depuración.
Item[ConfigurationProperty]	Obtiene o establece una propiedad o atributo de este elemento de configuración. (Heredado de ConfigurationElement)
Item[String]	Obtiene o establece una propiedad, un atributo o un elemento secundario de este elemento de configuración. (Heredado de ConfigurationElement)
LockAllAttributesExcept	Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement)
LockAllElementsExcept	Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement)
LockAttributes	Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement)
LockElements	Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement)
LockItem	Obtiene o establece un valor que indica si el elemento está bloqueado. (Heredado de ConfigurationElement)
Properties	Obtiene la colección de propiedades. (Heredado de ConfigurationElement)

Métodos

CopyFrom(ServiceModelExtensionElement)	Copia el contenido del elemento de configuración especificado a este elemento de configuración.
CreateBehavior()	Crea una extensión de comportamiento basada en la configuración actual. (Heredado de BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	Lee XML del archivo de configuración. (Heredado de ConfigurationElement)
Equals(Object)	Compara la instancia actual de ConfigurationElement con el objeto especificado. (Heredado de ConfigurationElement)
GetHashCode()	Obtiene un valor único que representa la instancia actual de ConfigurationElement. (Heredado de ConfigurationElement)
GetTransformedAssemblyString(String)	Devuelve la versión transformada del nombre de ensamblado especificado. (Heredado de ConfigurationElement)
GetTransformedTypeString(String)	Devuelve la versión transformada del nombre de tipo especificado. (Heredado de ConfigurationElement)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Init()	Establece el objeto ConfigurationElement en su estado inicial. (Heredado de ConfigurationElement)
InitializeDefault()	Se utiliza para inicializar un conjunto predeterminado de valores para el objeto ConfigurationElement. (Heredado de ConfigurationElement)
IsModified()	Obtiene un valor que especifica si se ha modificado este elemento de configuración. (Heredado de ServiceModelExtensionElement)
IsReadOnly()	Obtiene un valor que indica si el objeto ConfigurationElement es de solo lectura. (Heredado de ConfigurationElement)
ListErrors(IList)	Agrega a la lista que se pasa los errores de propiedad no válida que hay en este objeto ConfigurationElement y en todos los subelementos. (Heredado de ConfigurationElement)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtiene un valor que indica si se ha encontrado un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Obtiene un valor que indica si se ha encontrado un elemento desconocido durante la deserialización. (Heredado de ConfigurationElement)
OnRequiredPropertyNotFound(String)	Se inicia una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement)
PostDeserialize()	Se llama a este método después de la deserialización. (Heredado de ConfigurationElement)
PreSerialize(XmlWriter)	Se llama a este método antes de la serialización. (Heredado de ConfigurationElement)
Reset(ConfigurationElement)	Restablece el estado interno de este objeto de elemento de configuración, incluidos los bloqueos y las colecciones de propiedades. (Heredado de ServiceModelExtensionElement)
ResetModified()	Restablece el valor del método IsModified() en `false` cuando se implementa en una clase derivada. (Heredado de ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Escribe el contenido de este elemento de configuración en el archivo de configuración. (Heredado de ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Escribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Establece una propiedad en el valor especificado. (Heredado de ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Establece el valor de propiedad para el elemento de configuración si el valor no es el predeterminado. (Heredado de ServiceModelConfigurationElement)
SetReadOnly()	Establece la propiedad IsReadOnly() para el objeto ConfigurationElement y todos los subelementos. (Heredado de ConfigurationElement)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifica el objeto ConfigurationElement para quitar todos los valores que no se deben guardar. (Heredado de ConfigurationElement)

Se aplica a

Consulte también

<serviceDebug>

Compartir vía