Condividi tramite

ServiceDebugElement Classe

Definizione

Spazio dei nomi:
System.ServiceModel.Configuration
Assembly:
System.ServiceModel.dll

Rappresenta un elemento di configurazione che specifica le funzionalità di debug e informazioni della Guida per un servizio Windows Communication Foundation (WCF). Questa 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 usare un file di configurazione per abilitare la funzionalità della pagina della Guida HTML e restituire le informazioni sulle eccezioni all'interno di un errore SOAP al client a scopo di debug (oltre ad abilitare il 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 IncludeExceptionDetailInFaults proprietà su a true livello di codice, è possibile abilitare il flusso di informazioni sulle eccezioni gestite al client a scopo di debug, nonché la pubblicazione di file di informazioni HTML per gli utenti che esplorano il servizio nei Web browser.

Attenzione

La restituzione di informazioni sulle eccezioni gestite ai servizi può essere un rischio per la sicurezza. Ciò è dovuto al fatto che i dettagli dell'eccezione espongono informazioni sull'implementazione interna del client che potrebbe essere usata da servizi non autorizzati.

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

Le HttpHelpPageUrl proprietà e HttpsHelpPageUrl controllano la posizione della pagina della Guida HTML visualizzata.

Per abilitare o disabilitare una delle funzionalità usando un file di ServiceDebugElement 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 elemento con il nome che corrisponde al valore dell'attributo del behaviorConfiguration 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 <di comportamento> del passaggio 2 e abilitare o disabilitare le varie proprietà appropriate per lo scenario.

Per un esempio specifico, vedere la sezione Esempio.

Costruttori

Nome Descrizione
ServiceDebugElement()

Inizializza una nuova istanza della classe ServiceDebugElement.

Proprietà

Nome Descrizione
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 primo livello Configuration che rappresenta la gerarchia di configurazione a cui appartiene l'istanza corrente ConfigurationElement .

(Ereditato da ConfigurationElement)
ElementInformation

Ottiene un ElementInformation oggetto che contiene le informazioni e le funzionalità 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 CurrentConfiguration proprietà è 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 nell'indirizzo specificato dalla HttpHelpPageUrl proprietà .
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 nell'indirizzo specificato dalla HttpsHelpPageUrl proprietà .
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 degli 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 la raccolta di attributi bloccati.

(Ereditato da ConfigurationElement)
LockAllElementsExcept

Ottiene la raccolta di elementi bloccati.

(Ereditato da ConfigurationElement)
LockAttributes

Ottiene la raccolta di attributi bloccati.

(Ereditato da ConfigurationElement)
LockElements

Ottiene la raccolta 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

Nome Descrizione
CopyFrom(ServiceModelExtensionElement)

Copia il contenuto dell'elemento di configurazione specificato in questo elemento di configurazione.
CreateBehavior()

Crea un'estensione del comportamento in base alle 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 ConfigurationElement con l'oggetto specificato.

(Ereditato da ConfigurationElement)
GetHashCode()

Ottiene un valore univoco che rappresenta l'istanza corrente ConfigurationElement .

(Ereditato da ConfigurationElement)
GetTransformedAssemblyString(String)

Restituisce la versione trasformata del nome dell'assembly specificato.

(Ereditato da ConfigurationElement)
GetTransformedTypeString(String)

Restituisce la versione trasformata del nome del tipo specificato.

(Ereditato da ConfigurationElement)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
Init()

Imposta l'oggetto ConfigurationElement sullo stato iniziale.

(Ereditato da ConfigurationElement)
InitializeDefault()

Utilizzato per inizializzare un set 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 gli errori di proprietà non validi in questo ConfigurationElement oggetto e in tutti i sottoelementi all'elenco passato.

(Ereditato da ConfigurationElement)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
OnDeserializeUnrecognizedAttribute(String, String)

Ottiene un valore che indica se viene rilevato un attributo sconosciuto durante la deserializzazione.

(Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Ottiene un valore che indica se durante la deserializzazione viene rilevato un elemento sconosciuto.

(Ereditato da ConfigurationElement)
OnRequiredPropertyNotFound(String)

Genera un'eccezione quando non viene trovata una proprietà obbligatoria.

(Ereditato da ConfigurationElement)
PostDeserialize()

Chiamato dopo la deserializzazione.

(Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)

Chiamato prima della serializzazione.

(Ereditato da ConfigurationElement)
Reset(ConfigurationElement)

Reimposta lo stato interno di questo oggetto elemento di configurazione, inclusi i blocchi e gli insiemi di proprietà.

(Ereditato da ServiceModelExtensionElement)
ResetModified()

Reimposta il valore del IsModified() metodo su false quando 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 quando implementato 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 IsReadOnly() proprietà 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 per rimuovere tutti i valori che non devono essere salvati.

(Ereditato da ConfigurationElement)

Si applica a

Vedi anche