ServiceDebugElement Classe

  • Riferimento

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)

Si applica a

Vedi anche