ServiceDebugElement Classe

Référence

Définition

Espace de noms:: System.ServiceModel.Configuration

Assembly:: System.ServiceModel.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente un élément de configuration qui spécifie des fonctionnalités relatives aux informations de débogage et d'aide pour un service Windows Communication Foundation (WCF). Cette classe ne peut pas être héritée.

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

Héritage: Object

ConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Héritage: Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Exemples

L'exemple de code suivant indique comment utiliser un fichier de configuration pour activer la fonctionnalité de page d'aide HTML et retourner au client des informations relatives aux exceptions dans une erreur SOAP à des fins de débogage (en plus de l'activation de la prise en charge des métadonnées).

<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>

Remarques

Si vous affectez par programme la valeur IncludeExceptionDetailInFaults à la propriété true, vous pouvez activer le flux d'informations sur les exceptions managées pour le client à des fins de débogage, ainsi que la publication de fichiers d'informations HTML pour les utilisateurs qui parcourent le service avec un navigateur Web.

Attention

Le retour aux services des informations sur les exceptions managées peut entraîner un problème de sécurité. En effet, les détails des exceptions exposent des informations relatives à l'implémentation interne du client qui pourraient être utilisées par des services non autorisés.

Les propriétés HttpHelpPageEnabled et HttpsHelpPageEnabled indiquent au service de publier des fichiers d'aide HTML lorsqu'il est affiché à l'aide d'un navigateur HTML.

Les propriétés HttpHelpPageUrl et HttpsHelpPageUrl déterminent l'emplacement de la page d'aide HTML affichée.

Pour activer ou désactiver l’une des fonctionnalités ServiceDebugElement à l’aide d’un fichier de configuration, procédez comme suit :

Ajoutez un behaviorConfiguration attribut à l’élément <de service> pour votre service WCF. (Les comportements de point de terminaison sont configurés sur <endpoint> les éléments ; les comportements de service sur <les éléments de service> .)
Ajoutez ou créez une <section serviceBehaviors> et ajoutez un <élément de comportement> à celle-ci avec le nom correspondant à la valeur d’attribut de l’étape behaviorConfiguration 1. (Les comportements de point de terminaison sont configurés à l’aide d’un <élément endpointBehaviors> ; les comportements de service sont configurés à l’aide d’un <élément serviceBehaviors> .
Ajoutez un <élément serviceDebug> à l’élément behavior> de l’étape< 2 et activez ou désactivez les différentes propriétés appropriées à votre scénario.

Pour obtenir un exemple spécifique, consultez la section Exemple.

Constructeurs

ServiceDebugElement()

Initialise une nouvelle instance de la classe ServiceDebugElement.

Propriétés

BehaviorType	Obtient le type de cet élément de comportement.
ConfigurationElementName	Obtient le nom de cet élément de configuration. (Hérité de ServiceModelExtensionElement)
CurrentConfiguration	Obtient une référence à l'instance Configuration de niveau supérieur qui représente la hiérarchie de configuration à laquelle l'instance ConfigurationElement actuelle appartient. (Hérité de ConfigurationElement)
ElementInformation	Obtient un objet ElementInformation qui contient les fonctionnalités et informations non personnalisables de l'objet ConfigurationElement. (Hérité de ConfigurationElement)
ElementProperty	Obtient l'objet ConfigurationElementProperty qui représente l'objet ConfigurationElement lui-même. (Hérité de ConfigurationElement)
EvaluationContext	Obtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement)
HasContext	Obtient une valeur qui indique si la propriété CurrentConfiguration a la valeur `null`. (Hérité de ConfigurationElement)
HttpHelpPageBinding	Obtient ou définit une valeur de chaîne qui spécifie la liaison à utiliser lorsque HTTP est utilisé pour accéder à la page d'aide du service.
HttpHelpPageBindingConfiguration	Obtient ou définit une chaîne qui pointe sur une section XML, définissant ainsi les informations complémentaires de configuration pour la liaison spécifiée dans HttpHelpPageBinding.
HttpHelpPageEnabled	Obtient ou définit une valeur qui indique si Windows Communication Foundation (WCF) publie une page d’aide HTML à l’adresse spécifiée par la propriété HttpHelpPageUrl.
HttpHelpPageUrl	Obtient ou définit l'emplacement auquel le fichier d'aide HTML est publié.
HttpsHelpPageBinding	Obtient ou définit une valeur de chaîne qui spécifie la liaison à utiliser lorsque HTTPS est utilisé pour accéder à la page d’aide du service.
HttpsHelpPageBindingConfiguration	Obtient ou définit une chaîne qui pointe sur une section XML, définissant ainsi les informations complémentaires de configuration pour la liaison spécifiée dans HttpsHelpPageBinding.
HttpsHelpPageEnabled	Obtient ou définit une valeur qui spécifie si Windows Communication Foundation (WCF) retourne un fichier d'aide HTML sur HTTPS à l'adresse spécifiée par la propriété HttpsHelpPageUrl.
HttpsHelpPageUrl	Obtient ou définit l'emplacement où un fichier d'aide HTML est publié pour la récupération à l'aide de HTTPS.
IncludeExceptionDetailInFaults	Obtient ou définit une valeur qui spécifie si les informations sur les exceptions managées doivent être incluses dans le détail des erreurs SOAP retournées au client à des fins de débogage.
Item[ConfigurationProperty]	Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement)
Item[String]	Obtient ou définit une propriété, un attribut ou un élément enfant de cet élément de configuration. (Hérité de ConfigurationElement)
LockAllAttributesExcept	Obtient la collection d'attributs verrouillés. (Hérité de ConfigurationElement)
LockAllElementsExcept	Obtient la collection d'éléments verrouillés. (Hérité de ConfigurationElement)
LockAttributes	Obtient la collection d'attributs verrouillés. (Hérité de ConfigurationElement)
LockElements	Obtient la collection d'éléments verrouillés. (Hérité de ConfigurationElement)
LockItem	Obtient ou définit une valeur indiquant si l'élément est verrouillé. (Hérité de ConfigurationElement)
Properties	Obtient la collection de propriétés. (Hérité de ConfigurationElement)

Méthodes

CopyFrom(ServiceModelExtensionElement)	Copie le contenu de l'élément de configuration spécifié vers cet élément de configuration.
CreateBehavior()	Crée une extension de comportement basée sur les paramètres de configuration actuels. (Hérité de BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	Lit du XML à partir du fichier de configuration. (Hérité de ConfigurationElement)
Equals(Object)	Compare l’instance de ConfigurationElement actuelle à l’objet spécifié. (Hérité de ConfigurationElement)
GetHashCode()	Obtient une valeur unique représentant l'instance actuelle de ConfigurationElement. (Hérité de ConfigurationElement)
GetTransformedAssemblyString(String)	Retourne la version transformée du nom de l'assembly spécifié. (Hérité de ConfigurationElement)
GetTransformedTypeString(String)	Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Init()	Rétablit l’état initial de l’objet ConfigurationElement. (Hérité de ConfigurationElement)
InitializeDefault()	Utilisé pour initialiser un jeu de valeurs par défaut pour l'objet ConfigurationElement. (Hérité de ConfigurationElement)
IsModified()	Obtient une valeur qui spécifie si cet élément de configuration a été modifié. (Hérité de ServiceModelExtensionElement)
IsReadOnly()	Obtient une valeur indiquant si l’objet ConfigurationElement est en lecture seule. (Hérité de ConfigurationElement)
ListErrors(IList)	Ajoute les erreurs de propriété non valide dans cet objet ConfigurationElement et dans tous les sous-éléments à la liste passée. (Hérité de ConfigurationElement)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtient une valeur indiquant si un attribut inconnu est rencontré pendant la désérialisation. (Hérité de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Obtient une valeur indiquant si un élément inconnu est rencontré pendant la désérialisation. (Hérité de ConfigurationElement)
OnRequiredPropertyNotFound(String)	Lève une exception lorsqu'une propriété requise est introuvable. (Hérité de ConfigurationElement)
PostDeserialize()	Appelé après la désérialisation. (Hérité de ConfigurationElement)
PreSerialize(XmlWriter)	Appelé avant la sérialisation. (Hérité de ConfigurationElement)
Reset(ConfigurationElement)	Rétablit l’état interne de cet objet d’élément de configuration, y compris les verrouillages et les collections de propriétés. (Hérité de ServiceModelExtensionElement)
ResetModified()	Réinitialise la valeur de la méthode IsModified() à `false` en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Écrit le contenu de cet élément de configuration dans le fichier de configuration. (Hérité de ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Écrit les balises extérieures de cet élément de configuration dans le fichier de configuration lorsqu'il est implémenté dans une classe dérivée. (Hérité de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Affecte la valeur spécifiée à une propriété. (Hérité de ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Définit la valeur de propriété de l'élément de configuration si celle-ci n'est pas la valeur par défaut. (Hérité de ServiceModelConfigurationElement)
SetReadOnly()	Définit la propriété IsReadOnly() pour l'objet ConfigurationElement et tous les sous-éléments. (Hérité de ConfigurationElement)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifie l'objet ConfigurationElement pour supprimer toutes les valeurs qui ne doivent pas être enregistrées. (Hérité de ConfigurationElement)

S’applique à

Voir aussi

<serviceDebug>