ServiceDebugElement Classe

Definizione

Spazio dei nomi:

System.ServiceModel.Configuration

Assembly:

System.ServiceModel.dll

Rappresenta un elemento di configurazione che specifica funzionalità di debug e di informazioni della Guida per un servizio Windows Communication Foundation (WCF). La classe non può essere ereditata.

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

Ereditarietà

Object

ConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement

ServiceDebugElement

Ereditarietà

Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement

ServiceDebugElement

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare un file di configurazione per abilitare la funzionalità delle pagine della Guida HTML e restituire al client informazioni sulle eccezioni all'interno di un errore SOAP a scopo di debug (in aggiunta all'abilitazione del supporto dei metadati).

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

Commenti

Se si imposta la proprietà IncludeExceptionDetailInFaults su true a livello di codice, è possibile abilitare il flusso di informazioni sulle eccezioni gestite al client a fini di debug, nonché la pubblicazione di file di informazioni HTML per gli utenti che accedono al servizio tramite browser Web.

Attenzione

La restituzione di informazioni sulle eccezioni gestite ai servizi può costituire un problema per la sicurezza. Questo perché i dettagli sulle eccezioni espongono informazioni sull'implementazione interna del client che potrebbero venire utilizzate da servizi non autorizzati.

Le proprietà HttpHelpPageEnabled e HttpsHelpPageEnabled indicano al servizio di pubblicare file della Guida HTML quando il servizio viene visualizzato tramite un browser HTML.

Le proprietà HttpHelpPageUrl e HttpsHelpPageUrl controllano il percorso della pagina della Guida HTML visualizzata.

Per abilitare o disabilitare una delle funzionalità ServiceDebugElement utilizzando un file di configurazione, è necessario:

1. Aggiungere un behaviorConfiguration attributo all'elemento <del servizio> per il servizio WCF. I comportamenti degli endpoint vengono configurati sugli <endpoint> elementi; i comportamenti del servizio sugli< elementi del servizio>.

2. Aggiungere o creare una <sezione serviceBehaviors> e aggiungere un <elemento di comportamento> a tale con il nome corrispondente al valore dell'attributo behaviorConfiguration del passaggio 1. I comportamenti degli endpoint vengono configurati usando un <elemento endpointBehaviors> . I comportamenti del servizio vengono configurati usando un <elemento serviceBehaviors> .

3. Aggiungere un <elemento serviceDebug> all'elemento <comportamento> del passaggio 2 e abilitare o disabilitare le varie proprietà appropriate per lo scenario.

Per un esempio specifico, vedere la sezione relativa agli esempi.

Costruttori

ServiceDebugElement()

Inizializza una nuova istanza della classe ServiceDebugElement.

Proprietà

BehaviorType	Ottiene il tipo di questo elemento di comportamento.
ConfigurationElementName	Ottiene il nome di questo elemento di configurazione. (Ereditato da ServiceModelExtensionElement)
CurrentConfiguration	Ottiene un riferimento all'istanza di Configuration di livello superiore che rappresenta la gerarchia di configurazione cui appartiene l'istanza corrente di ConfigurationElement. (Ereditato da ConfigurationElement)
ElementInformation	Ottiene un oggetto ElementInformation contenente le funzionalità e le informazioni non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
ElementProperty	Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement)
EvaluationContext	Ottiene l'oggetto ContextInformation per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
HasContext	Ottiene un valore che indica se la proprietà CurrentConfiguration è null. (Ereditato da ConfigurationElement)
HttpHelpPageBinding	Ottiene o imposta un valore stringa che specifica l'associazione da utilizzare quando viene utilizzato HTTP per accedere alla pagina della Guida del servizio.
HttpHelpPageBindingConfiguration	Ottiene o imposta una stringa che punta a una sezione XML che definisce informazioni di configurazione aggiuntive per l'associazione specificata in HttpHelpPageBinding.
HttpHelpPageEnabled	Ottiene o imposta un valore che indica se Windows Communication Foundation (WCF) pubblica una pagina della Guida HTML all'indirizzo specificato dalla proprietà HttpHelpPageUrl.
HttpHelpPageUrl	Ottiene o imposta il percorso in cui viene pubblicato il file della Guida HTML.
HttpsHelpPageBinding	Ottiene o imposta un valore stringa che specifica l'associazione da utilizzare quando viene utilizzato HTTPS per accedere alla pagina della Guida del servizio.
HttpsHelpPageBindingConfiguration	Ottiene o imposta una stringa che punta a una sezione XML che definisce informazioni di configurazione aggiuntive per l'associazione specificata in HttpsHelpPageBinding.
HttpsHelpPageEnabled	Ottiene o imposta un valore che specifica se Windows Communication Foundation (WCF) restituisce un file della Guida HTML su HTTPS all'indirizzo specificato dalla proprietà HttpsHelpPageUrl.
HttpsHelpPageUrl	Ottiene o imposta il percorso in cui viene pubblicato un file della Guida HTML per il recupero tramite HTTPS.
IncludeExceptionDetailInFaults	Ottiene o imposta un valore che specifica se includere informazioni sulle eccezioni gestite nei dettagli sugli errori SOAP restituiti al client a scopo di debug.
Item[ConfigurationProperty]	Ottiene o imposta una proprietà o un attributo di questo elemento di configurazione. (Ereditato da ConfigurationElement)
Item[String]	Ottiene o imposta una proprietà, un attributo o un elemento figlio di questo elemento di configurazione. (Ereditato da ConfigurationElement)
LockAllAttributesExcept	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockAllElementsExcept	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockAttributes	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockElements	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockItem	Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement)
Properties	Ottiene la raccolta di proprietà. (Ereditato da ConfigurationElement)

Metodi

CopyFrom(ServiceModelExtensionElement)	Copia il contenuto dell'elemento di configurazione specificato in questo elemento di configurazione.
CreateBehavior()	Crea un'estensione di comportamento basata sulle impostazioni di configurazione correnti. (Ereditato da BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement)
Equals(Object)	Confronta l'istanza corrente di ConfigurationElement con l'oggetto specificato. (Ereditato da ConfigurationElement)
GetHashCode()	Ottiene un valore univoco che rappresenta l'istanza corrente di ConfigurationElement. (Ereditato da ConfigurationElement)
GetTransformedAssemblyString(String)	Restituisce la versione trasformata del nome di assembly specificato. (Ereditato da ConfigurationElement)
GetTransformedTypeString(String)	Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Init()	Ripristina lo stato iniziale dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
InitializeDefault()	Da utilizzare per inizializzare un insieme predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
IsModified()	Ottiene un valore che specifica se questo elemento di configurazione è stato modificato. (Ereditato da ServiceModelExtensionElement)
IsReadOnly()	Ottiene un valore che indica se l'oggetto ConfigurationElement è di sola lettura. (Ereditato da ConfigurationElement)
ListErrors(IList)	Aggiunge all'elenco passato gli errori di proprietà non valida di questo oggetto ConfigurationElement e di tutti i sottoelementi. (Ereditato da ConfigurationElement)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ottiene un valore che indica se viene incontrato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ottiene un valore che indica se viene incontrato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement)
OnRequiredPropertyNotFound(String)	Genera un'eccezione quando una proprietà obbligatoria non viene trovata. (Ereditato da ConfigurationElement)
PostDeserialize()	Da chiamare dopo la deserializzazione. (Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)	Da chiamare prima della serializzazione. (Ereditato da ConfigurationElement)
Reset(ConfigurationElement)	Reimposta lo stato interno di questo elemento di configurazione, blocchi e raccolte di proprietà compresi. (Ereditato da ServiceModelExtensionElement)
ResetModified()	Reimposta il valore del metodo IsModified() su false quando viene implementato in una classe derivata. (Ereditato da ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Scrive il contenuto di questo elemento di configurazione nel file di configurazione. (Ereditato da ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Scrive i tag esterni di questo elemento di configurazione nel file di configurazione in caso di implementazione in una classe derivata. (Ereditato da ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Imposta una proprietà sul valore specificato. (Ereditato da ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Imposta il valore della proprietà per l'elemento di configurazione se il valore non è il valore predefinito. (Ereditato da ServiceModelConfigurationElement)
SetReadOnly()	Imposta la proprietà IsReadOnly() per l'oggetto ConfigurationElement e tutti i sottoelementi. (Ereditato da ConfigurationElement)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifica l'oggetto ConfigurationElement in modo da rimuovere tutti i valori che non devono essere salvati. (Ereditato da ConfigurationElement)

Vedi anche

• <debugServizio>