ServiceDebugElement Klass

Definition

Namnområde:: System.ServiceModel.Configuration

Sammansättning:: System.ServiceModel.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Representerar ett konfigurationselement som anger felsöknings- och hjälpinformationsfunktioner för en Windows Communication Foundation-tjänst (WCF). Det går inte att ärva den här klassen.

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

Arv: Object

ConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Arv: Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Exempel

I följande kodexempel visas hur du använder en konfigurationsfil för att aktivera html-hjälpsidans funktion och returnera undantagsinformation i ett SOAP-fel tillbaka till klienten i felsökningssyfte (förutom att aktivera metadatastöd).

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

Kommentarer

Om du ställer in IncludeExceptionDetailInFaults egenskapen på true programmatiskt kan du aktivera flödet av hanterad undantagsinformation till klienten i felsökningssyfte, samt publicering av HTML-informationsfiler för användare som surfar på tjänsten i webbläsare.

Caution

Att returnera hanterad undantagsinformation till tjänster kan vara en säkerhetsrisk. Det beror på att undantagsinformation visar information om den interna klientimplementeringen som kan användas av obehöriga tjänster.

Egenskaperna HttpHelpPageEnabled och HttpsHelpPageEnabled instruerar tjänsten att publicera HTML-hjälpfiler när tjänsten visas med hjälp av en HTML-webbläsare.

Egenskaperna HttpHelpPageUrl och HttpsHelpPageUrl styr platsen för HTML-hjälpsidan som visas.

Om du vill aktivera eller inaktivera en av funktionerna med hjälp av ServiceDebugElement en konfigurationsfil måste du:

Lägg till ett behaviorConfiguration attribut till <tjänstelementet> för WCF-tjänsten. (Slutpunktsbeteenden konfigureras för <endpoint> element, tjänstbeteenden på <tjänstelement> .)
Lägg till i eller skapa ett <serviceBehaviors-avsnitt> och lägg till ett <beteendeelement> till det med namnet som matchar behaviorConfiguration attributvärdet från steg 1. (Slutpunktsbeteenden konfigureras med hjälp av ett <endpointBehaviors-element> . Tjänstbeteenden konfigureras med hjälp av ett <serviceBehaviors-element> .
Lägg till ett <serviceDebug-element> i <beteendeelementet> från steg 2 och aktivera eller inaktivera de olika egenskaper som är lämpliga för ditt scenario.

Ett specifikt exempel finns i avsnittet Exempel.

Konstruktorer

Name	Description
ServiceDebugElement()	Initierar en ny instans av ServiceDebugElement klassen.

Egenskaper

Name	Description
BehaviorType	Hämtar typen av det här beteendeelementet.
ConfigurationElementName	Hämtar namnet på det här konfigurationselementet. (Ärvd från ServiceModelExtensionElement)
CurrentConfiguration	Hämtar en referens till den översta instansen Configuration som representerar konfigurationshierarkin som den aktuella ConfigurationElement instansen tillhör. (Ärvd från ConfigurationElement)
ElementInformation	Hämtar ett ElementInformation objekt som innehåller den icke-anpassningsbara informationen och funktionerna i ConfigurationElement objektet. (Ärvd från ConfigurationElement)
ElementProperty	Hämtar objektet ConfigurationElementProperty som representerar ConfigurationElement själva objektet. (Ärvd från ConfigurationElement)
EvaluationContext	Hämtar ContextInformation-objektet för ConfigurationElement-objektet. (Ärvd från ConfigurationElement)
HasContext	Hämtar ett värde som anger om egenskapen CurrentConfiguration är `null`. (Ärvd från ConfigurationElement)
HttpHelpPageBinding	Hämtar eller anger ett strängvärde som anger bindningen som ska användas när HTTP används för att komma åt tjänstens hjälpsida.
HttpHelpPageBindingConfiguration	Hämtar eller anger en sträng som pekar på ett XML-avsnitt som definierar ytterligare konfigurationsinformation för bindningen som anges i HttpHelpPageBinding.
HttpHelpPageEnabled	Hämtar eller anger ett värde som anger om Windows Communication Foundation (WCF) publicerar en HTML-hjälpsida på den adress som anges av egenskapen HttpHelpPageUrl.
HttpHelpPageUrl	Hämtar eller anger den plats där HTML-hjälpfilen publiceras.
HttpsHelpPageBinding	Hämtar eller anger ett strängvärde som anger bindningen som ska användas när HTTPS används för att komma åt hjälpsidan för tjänsten.
HttpsHelpPageBindingConfiguration	Hämtar eller anger en sträng som pekar på ett XML-avsnitt som definierar ytterligare konfigurationsinformation för bindningen som anges i HttpsHelpPageBinding.
HttpsHelpPageEnabled	Hämtar eller anger ett värde som anger om Windows Communication Foundation (WCF) returnerar en HTML-hjälpfil via HTTPS på den adress som anges av egenskapen HttpsHelpPageUrl.
HttpsHelpPageUrl	Hämtar eller anger den plats där en HTML-hjälpfil publiceras för hämtning med HTTPS.
IncludeExceptionDetailInFaults	Hämtar eller anger ett värde som anger om hanterad undantagsinformation ska inkluderas i detalj för SOAP-fel som returneras till klienten i felsökningssyfte.
Item[ConfigurationProperty]	Hämtar eller anger en egenskap eller ett attribut för det här konfigurationselementet. (Ärvd från ConfigurationElement)
Item[String]	Hämtar eller anger en egenskap, ett attribut eller ett underordnat element i det här konfigurationselementet. (Ärvd från ConfigurationElement)
LockAllAttributesExcept	Hämtar samlingen med låsta attribut. (Ärvd från ConfigurationElement)
LockAllElementsExcept	Hämtar samlingen med låsta element. (Ärvd från ConfigurationElement)
LockAttributes	Hämtar samlingen med låsta attribut. (Ärvd från ConfigurationElement)
LockElements	Hämtar samlingen med låsta element. (Ärvd från ConfigurationElement)
LockItem	Hämtar eller anger ett värde som anger om elementet är låst. (Ärvd från ConfigurationElement)
Properties	Hämtar samlingen med egenskaper. (Ärvd från ConfigurationElement)

Metoder

Name	Description
CopyFrom(ServiceModelExtensionElement)	Kopierar innehållet i det angivna konfigurationselementet till det här konfigurationselementet.
CreateBehavior()	Skapar ett beteendetillägg baserat på de aktuella konfigurationsinställningarna. (Ärvd från BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	Läser XML från konfigurationsfilen. (Ärvd från ConfigurationElement)
Equals(Object)	Jämför den aktuella ConfigurationElement instansen med det angivna objektet. (Ärvd från ConfigurationElement)
GetHashCode()	Hämtar ett unikt värde som representerar den aktuella ConfigurationElement instansen. (Ärvd från ConfigurationElement)
GetTransformedAssemblyString(String)	Returnerar den transformerade versionen av det angivna sammansättningsnamnet. (Ärvd från ConfigurationElement)
GetTransformedTypeString(String)	Returnerar den transformerade versionen av det angivna typnamnet. (Ärvd från ConfigurationElement)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
Init()	Anger objektets ConfigurationElement ursprungliga tillstånd. (Ärvd från ConfigurationElement)
InitializeDefault()	Används för att initiera en standarduppsättning med värden för ConfigurationElement objektet. (Ärvd från ConfigurationElement)
IsModified()	Hämtar ett värde som anger om det här konfigurationselementet har ändrats. (Ärvd från ServiceModelExtensionElement)
IsReadOnly()	Hämtar ett värde som anger om objektet ConfigurationElement är skrivskyddat. (Ärvd från ConfigurationElement)
ListErrors(IList)	Lägger till felen invalid-property i det här ConfigurationElement objektet, och i alla underelement, i den överförda listan. (Ärvd från ConfigurationElement)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnDeserializeUnrecognizedAttribute(String, String)	Hämtar ett värde som anger om ett okänt attribut påträffas under deserialiseringen. (Ärvd från ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Hämtar ett värde som anger om ett okänt element påträffas under deserialiseringen. (Ärvd från ConfigurationElement)
OnRequiredPropertyNotFound(String)	Utlöser ett undantag när en obligatorisk egenskap inte hittas. (Ärvd från ConfigurationElement)
PostDeserialize()	Anropas efter deserialisering. (Ärvd från ConfigurationElement)
PreSerialize(XmlWriter)	Anropas före serialisering. (Ärvd från ConfigurationElement)
Reset(ConfigurationElement)	Återställer det interna tillståndet för det här konfigurationselementobjektet, inklusive låsen och egenskapssamlingarna. (Ärvd från ServiceModelExtensionElement)
ResetModified()	Återställer värdet för metoden till IsModified() när den `false` implementeras i en härledd klass. (Ärvd från ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Skriver innehållet i det här konfigurationselementet till konfigurationsfilen. (Ärvd från ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Skriver de yttre taggarna för det här konfigurationselementet till konfigurationsfilen när det implementeras i en härledd klass. (Ärvd från ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Anger en egenskap till det angivna värdet. (Ärvd från ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Anger egenskapsvärdet för konfigurationselementet om värdet inte är standardvärdet. (Ärvd från ServiceModelConfigurationElement)
SetReadOnly()	Anger egenskapen IsReadOnly() för ConfigurationElement objektet och alla underelement. (Ärvd från ConfigurationElement)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Ändrar objektet ConfigurationElement för att ta bort alla värden som inte ska sparas. (Ärvd från ConfigurationElement)

Gäller för

Se även

<serviceDebug>

Feedback

Var den här sidan till hjälp?