ServiceDebugElement Klas

Definitie

Naamruimte:: System.ServiceModel.Configuration

Assembly:: System.ServiceModel.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een configuratie-element waarmee foutopsporing en help-informatiefuncties voor een WCF-service (Windows Communication Foundation) worden opgegeven. Deze klasse kan niet worden overgenomen.

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

Overname: Object

ConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Overname: Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een configuratiebestand gebruikt om de html-helppaginafunctie in te schakelen en uitzonderingsgegevens in een SOAP-fout terug te sturen naar de client voor foutopsporing (naast het inschakelen van ondersteuning voor metagegevens).

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

Opmerkingen

Als u de IncludeExceptionDetailInFaults eigenschap true op programmatisch instelt, kunt u de stroom beheerde uitzonderingsgegevens naar de client inschakelen voor foutopsporingsdoeleinden, evenals de publicatie van HTML-informatiebestanden voor gebruikers die door de service bladeren in webbrowsers.

Caution

Het retourneren van beheerde uitzonderingsinformatie aan services kan een beveiligingsrisico zijn. Dit komt doordat uitzonderingsdetails informatie beschikbaar maken over de interne client-implementatie die kan worden gebruikt door niet-geautoriseerde services.

De HttpHelpPageEnabled en HttpsHelpPageEnabled eigenschappen geven de service opdracht om HTML Help-bestanden te publiceren wanneer de service wordt bekeken met behulp van een HTML-browser.

De HttpHelpPageUrl en HttpsHelpPageUrl eigenschappen bepalen de locatie van de HTML-Help-pagina die wordt weergegeven.

Als u een van de ServiceDebugElement functies met behulp van een configuratiebestand wilt in- of uitschakelen, moet u het volgende doen:

Voeg een behaviorConfiguration kenmerk toe aan het <service-element> voor uw WCF-service. (Eindpuntgedrag wordt geconfigureerd op <endpoint> elementen; servicegedrag op <service-elementen> .)
Voeg een <serviceBehaviors-sectie> toe aan of maak er een <gedragselement> aan toe met de naam die overeenkomt met de behaviorConfiguration kenmerkwaarde uit stap 1. (Eindpuntgedrag wordt geconfigureerd met behulp van een <endpointBehaviors-element> ; servicegedrag wordt geconfigureerd met behulp van een <serviceBehaviors-element> .
Voeg een <serviceDebug-element> toe aan het <gedragselement> uit stap 2 en schakel de verschillende eigenschappen in of uit die geschikt zijn voor uw scenario.

Zie de sectie Voorbeeld voor een specifiek voorbeeld.

Constructors

Name	Description
ServiceDebugElement()	Initialiseert een nieuw exemplaar van de ServiceDebugElement klasse.

Eigenschappen

Name	Description
BehaviorType	Hiermee haalt u het type van dit gedragselement op.
ConfigurationElementName	Hiermee haalt u de naam van dit configuratie-element op. (Overgenomen van ServiceModelExtensionElement)
CurrentConfiguration	Hiermee wordt een verwijzing opgehaald naar het exemplaar op het hoogste niveau Configuration dat de configuratiehiërarchie vertegenwoordigt waartoe het huidige ConfigurationElement exemplaar behoort. (Overgenomen van ConfigurationElement)
ElementInformation	Hiermee haalt u een ElementInformation object op dat de niet-aanpasbare informatie en functionaliteit van het ConfigurationElement object bevat. (Overgenomen van ConfigurationElement)
ElementProperty	Hiermee haalt u het ConfigurationElementProperty object op dat het ConfigurationElement object zelf vertegenwoordigt. (Overgenomen van ConfigurationElement)
EvaluationContext	Hiermee haalt u het ContextInformation object voor het ConfigurationElement object op. (Overgenomen van ConfigurationElement)
HasContext	Hiermee wordt een waarde opgehaald die aangeeft of de CurrentConfiguration eigenschap is `null`. (Overgenomen van ConfigurationElement)
HttpHelpPageBinding	Hiermee haalt u een tekenreekswaarde op die aangeeft welke binding moet worden gebruikt wanneer HTTP wordt gebruikt voor toegang tot de Help-pagina van de service.
HttpHelpPageBindingConfiguration	Hiermee haalt u een tekenreeks op die verwijst naar een XML-sectie die aanvullende configuratie-informatie definieert voor de binding die is opgegeven in HttpHelpPageBinding.
HttpHelpPageEnabled	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of Windows Communication Foundation (WCF) een HTML-helppagina publiceert op het adres dat is opgegeven door de eigenschap HttpHelpPageUrl.
HttpHelpPageUrl	Hiermee haalt u de locatie op waarop het HTML-Help-bestand wordt gepubliceerd of stelt u deze in.
HttpsHelpPageBinding	Hiermee haalt u een tekenreekswaarde op die aangeeft welke binding moet worden gebruikt wanneer HTTPS wordt gebruikt voor toegang tot de Help-pagina van de service.
HttpsHelpPageBindingConfiguration	Hiermee haalt u een tekenreeks op die verwijst naar een XML-sectie die aanvullende configuratie-informatie definieert voor de binding die is opgegeven in HttpsHelpPageBinding.
HttpsHelpPageEnabled	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of Windows Communication Foundation (WCF) een HTML-helpbestand retourneert via HTTPS op het adres dat is opgegeven door de eigenschap HttpsHelpPageUrl.
HttpsHelpPageUrl	Hiermee wordt de locatie opgehaald of ingesteld waarop een HTML-Help-bestand wordt gepubliceerd voor het ophalen met behulp van HTTPS.
IncludeExceptionDetailInFaults	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of beheerde uitzonderingsgegevens moeten worden opgenomen in de details van SOAP-fouten die worden geretourneerd naar de client voor foutopsporing.
Item[ConfigurationProperty]	Hiermee wordt een eigenschap of kenmerk van dit configuratie-element opgehaald of ingesteld. (Overgenomen van ConfigurationElement)
Item[String]	Hiermee wordt een eigenschap, kenmerk of onderliggend element van dit configuratie-element opgehaald of ingesteld. (Overgenomen van ConfigurationElement)
LockAllAttributesExcept	Hiermee haalt u de verzameling vergrendelde kenmerken op. (Overgenomen van ConfigurationElement)
LockAllElementsExcept	Hiermee haalt u de verzameling vergrendelde elementen op. (Overgenomen van ConfigurationElement)
LockAttributes	Hiermee haalt u de verzameling vergrendelde kenmerken op. (Overgenomen van ConfigurationElement)
LockElements	Hiermee haalt u de verzameling vergrendelde elementen op. (Overgenomen van ConfigurationElement)
LockItem	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het element is vergrendeld. (Overgenomen van ConfigurationElement)
Properties	Hiermee haalt u de verzameling eigenschappen op. (Overgenomen van ConfigurationElement)

Methoden

Name	Description
CopyFrom(ServiceModelExtensionElement)	Hiermee kopieert u de inhoud van het opgegeven configuratie-element naar dit configuratie-element.
CreateBehavior()	Hiermee maakt u een gedragsextensie op basis van de huidige configuratie-instellingen. (Overgenomen van BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	Leest XML uit het configuratiebestand. (Overgenomen van ConfigurationElement)
Equals(Object)	Vergelijkt het huidige ConfigurationElement exemplaar met het opgegeven object. (Overgenomen van ConfigurationElement)
GetHashCode()	Hiermee haalt u een unieke waarde op die het huidige ConfigurationElement exemplaar vertegenwoordigt. (Overgenomen van ConfigurationElement)
GetTransformedAssemblyString(String)	Retourneert de getransformeerde versie van de opgegeven assemblynaam. (Overgenomen van ConfigurationElement)
GetTransformedTypeString(String)	Retourneert de getransformeerde versie van de opgegeven typenaam. (Overgenomen van ConfigurationElement)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
Init()	Hiermee stelt u het object in op de ConfigurationElement oorspronkelijke status. (Overgenomen van ConfigurationElement)
InitializeDefault()	Wordt gebruikt om een standaardset waarden voor het ConfigurationElement object te initialiseren. (Overgenomen van ConfigurationElement)
IsModified()	Hiermee wordt een waarde opgehaald die aangeeft of dit configuratie-element is gewijzigd. (Overgenomen van ServiceModelExtensionElement)
IsReadOnly()	Hiermee wordt een waarde opgehaald die aangeeft of het ConfigurationElement object het kenmerk Alleen-lezen heeft. (Overgenomen van ConfigurationElement)
ListErrors(IList)	Voegt de fouten met ongeldige eigenschappen in dit ConfigurationElement object en in alle subelementen toe aan de doorgegeven lijst. (Overgenomen van ConfigurationElement)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnDeserializeUnrecognizedAttribute(String, String)	Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend kenmerk wordt aangetroffen tijdens deserialisatie. (Overgenomen van ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend element wordt aangetroffen tijdens deserialisatie. (Overgenomen van ConfigurationElement)
OnRequiredPropertyNotFound(String)	Genereert een uitzondering wanneer een vereiste eigenschap niet wordt gevonden. (Overgenomen van ConfigurationElement)
PostDeserialize()	Gebeld na ontserialisatie. (Overgenomen van ConfigurationElement)
PreSerialize(XmlWriter)	Aangeroepen vóór serialisatie. (Overgenomen van ConfigurationElement)
Reset(ConfigurationElement)	Hiermee stelt u de interne status van dit configuratie-elementobject opnieuw in, inclusief de vergrendelingen en de eigenschappenverzamelingen. (Overgenomen van ServiceModelExtensionElement)
ResetModified()	Hiermee stelt u de waarde van de methode IsModified() opnieuw in wanneer deze `false` wordt geïmplementeerd in een afgeleide klasse. (Overgenomen van ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Hiermee schrijft u de inhoud van dit configuratie-element naar het configuratiebestand. (Overgenomen van ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Hiermee schrijft u de buitenste tags van dit configuratie-element naar het configuratiebestand wanneer het wordt geïmplementeerd in een afgeleide klasse. (Overgenomen van ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Hiermee stelt u een eigenschap in op de opgegeven waarde. (Overgenomen van ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Hiermee stelt u de eigenschapswaarde voor het configuratie-element in als de waarde niet de standaardwaarde is. (Overgenomen van ServiceModelConfigurationElement)
SetReadOnly()	Hiermee stelt u de IsReadOnly() eigenschap voor het ConfigurationElement object en alle subelementen in. (Overgenomen van ConfigurationElement)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Hiermee wijzigt u het ConfigurationElement object om alle waarden te verwijderen die niet mogen worden opgeslagen. (Overgenomen van ConfigurationElement)

Van toepassing op

Zie ook

<serviceDebug>

Feedback

Is deze pagina nuttig?