ServiceDebugElement Klasa

Definicja

Reprezentuje element konfiguracji, który określa funkcje debugowania i informacje pomocy dla usługi Windows Communication Foundation (WCF).Represents a configuration element that specifies debugging and help information features for a Windows Communication Foundation (WCF) service. Klasa ta nie może być dziedziczona.This class cannot be inherited.

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

Przykłady

Poniższy przykład kodu pokazuje, jak używać pliku konfiguracji w celu włączenia funkcji strony pomocy HTML i zwrócenia informacji o wyjątku wewnątrz błędu protokołu SOAP z powrotem do klienta na potrzeby debugowania (oprócz włączania obsługi metadanych).The following code example shows how to use a configuration file to enable the HTML help page feature and return exception information inside a SOAP fault back to the client for debugging purposes (in addition to enabling metadata support).

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

Uwagi

Jeśli właściwość zostanie ustawiona IncludeExceptionDetailInFaults na true programowo, można włączyć przepływ informacji o zarządzanych wyjątkach do klienta na potrzeby debugowania, a także publikację plików informacji HTML dla użytkowników przeglądających usługę w przeglądarkach sieci Web.If you set the IncludeExceptionDetailInFaults property to true programmatically, you can enable the flow of managed exception information to the client for debugging purposes, as well as the publication of HTML information files for users browsing the service in Web browsers.

Przestroga

Zwrócenie informacji o wyjątku zarządzanym do usług może stanowić zagrożenie bezpieczeństwa.Returning managed exception information to services can be a security risk. Wynika to z faktu, że szczegóły wyjątku ujawniają informacje o wewnętrznej implementacji klienta, które mogą być używane przez nieautoryzowane usługi.This is because exception details expose information about the internal client implementation that could be used by unauthorized services.

HttpHelpPageEnabledWłaściwości i HttpsHelpPageEnabled instruują usługę, aby opublikowała pliki pomocy HTML w przypadku wyświetlenia usługi przy użyciu przeglądarki HTML.The HttpHelpPageEnabled and HttpsHelpPageEnabled properties instruct the service to publish HTML help files when the service is viewed using an HTML browser.

HttpHelpPageUrlWłaściwości i HttpsHelpPageUrl kontrolują lokalizację wyświetlanej strony pomocy HTML.The HttpHelpPageUrl and HttpsHelpPageUrl properties control the location of the HTML help page that is viewed.

Aby włączyć lub wyłączyć jedną z ServiceDebugElement funkcji przy użyciu pliku konfiguracji, należy wykonać następujące działania:To enable or disable one of the ServiceDebugElement features using a configuration file, you must:

  1. Dodaj behaviorConfiguration atrybut do elementu < usługi > dla usługi WCF.Add a behaviorConfiguration attribute to the <service> element for your WCF service. (Zachowania punktów końcowych są konfigurowane dla <endpoint> elementów; zachowania usługi dla elementów < usługi > ).(Endpoint behaviors are configured on <endpoint> elements; service behaviors on <service> elements.)

  2. Dodaj do lub utwórz sekcję < serviceBehaviors > i Dodaj element < > Behavior do tego elementu o nazwie odpowiadającej behaviorConfiguration wartości atrybutu z kroku 1.Add to or create a <serviceBehaviors> section and add a <behavior> element to that with the name that matches the behaviorConfiguration attribute value from step 1. (Zachowania punktów końcowych konfiguruje się za pomocą elementu < endpointBehaviors > ; zachowania usługi są konfigurowane przy użyciu elementu < serviceBehaviors > .(Endpoint behaviors are configured using an <endpointBehaviors> element; service behaviors are configured using a <serviceBehaviors> element.

  3. Dodaj element < serviceDebug > do elementu < Behavior > z kroku 2 i Włącz lub Wyłącz różne właściwości odpowiednie dla danego scenariusza.Add a <serviceDebug> element to the <behavior> element from step 2 and enable or disable the various properties appropriate to your scenario.

Aby zapoznać się z określonym przykładem, zapoznaj się z sekcją przykładową.For a specific example, see the Example section.

Konstruktory

ServiceDebugElement()

Inicjuje nowe wystąpienie klasy ServiceDebugElement.Initializes a new instance of the ServiceDebugElement class.

Właściwości

BehaviorType

Pobiera typ tego elementu zachowania.Gets the type of this behavior element.

ConfigurationElementName

Pobiera nazwę tego elementu konfiguracji.Gets the name of this configuration element.

(Odziedziczone po ServiceModelExtensionElement)
CurrentConfiguration

Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration , które reprezentuje hierarchię konfiguracji, do której ConfigurationElement należy bieżące wystąpienie.Gets a reference to the top-level Configuration instance that represents the configuration hierarchy that the current ConfigurationElement instance belongs to.

(Odziedziczone po ConfigurationElement)
ElementInformation

Pobiera ElementInformation obiekt, który zawiera informacje, które nie są dostosowywane i funkcje ConfigurationElement obiektu.Gets an ElementInformation object that contains the non-customizable information and functionality of the ConfigurationElement object.

(Odziedziczone po ConfigurationElement)
ElementProperty

Pobiera ConfigurationElementProperty obiekt, który reprezentuje ConfigurationElement sam obiekt.Gets the ConfigurationElementProperty object that represents the ConfigurationElement object itself.

(Odziedziczone po ConfigurationElement)
EvaluationContext

Pobiera ContextInformation obiekt dla ConfigurationElement obiektu.Gets the ContextInformation object for the ConfigurationElement object.

(Odziedziczone po ConfigurationElement)
HasContext

Pobiera wartość wskazującą, czy CurrentConfiguration Właściwość jest null .Gets a value that indicates whether the CurrentConfiguration property is null.

(Odziedziczone po ConfigurationElement)
HttpHelpPageBinding

Pobiera lub ustawia wartość ciągu określającą powiązanie, które ma być używane, gdy protokół HTTP jest używany do uzyskiwania dostępu do strony pomocy usługi.Gets or sets a string value that specifies the binding to be used when HTTP is utilized to access the service help page.

HttpHelpPageBindingConfiguration

Pobiera lub ustawia ciąg wskazujący na sekcję XML definiującą dodatkowe informacje konfiguracyjne dla powiązania określonego w HttpHelpPageBinding .Gets or sets a string that points to an XML section defining additional configuration information for the binding specified in HttpHelpPageBinding.

HttpHelpPageEnabled

Pobiera lub ustawia wartość wskazującą, czy Windows Communication Foundation (WCF) publikuje stronę pomocy HTML pod adresem określonym przez HttpHelpPageUrl Właściwość.Gets or sets a value that indicates whether Windows Communication Foundation (WCF) publishes an HTML help page at the address specified by the HttpHelpPageUrl property.

HttpHelpPageUrl

Pobiera lub ustawia lokalizację, w której publikowany jest plik pomocy HTML.Gets or sets the location at which the HTML help file is published.

HttpsHelpPageBinding

Pobiera lub ustawia wartość ciągu określającą powiązanie, które ma być używane podczas korzystania z protokołu HTTPS w celu uzyskania dostępu do strony pomocy usługi.Gets or sets a string value that specifies the binding to be used when HTTPS is utilized to access the service help page.

HttpsHelpPageBindingConfiguration

Pobiera lub ustawia ciąg wskazujący na sekcję XML definiującą dodatkowe informacje konfiguracyjne dla powiązania określonego w HttpsHelpPageBinding .Gets or sets a string that points to an XML section defining additional configuration information for the binding specified in HttpsHelpPageBinding.

HttpsHelpPageEnabled

Pobiera lub ustawia wartość określającą, czy Windows Communication Foundation (WCF) zwraca plik pomocy HTML za pośrednictwem protokołu HTTPS pod adresem określonym przez HttpsHelpPageUrl Właściwość.Gets or sets a value that specifies whether Windows Communication Foundation (WCF) returns an HTML help file over HTTPS at the address specified by the HttpsHelpPageUrl property.

HttpsHelpPageUrl

Pobiera lub ustawia lokalizację, w której publikowany jest plik pomocy HTML do pobrania przy użyciu protokołu HTTPS.Gets or sets the location at which an HTML help file is published for retrieval using HTTPS.

IncludeExceptionDetailInFaults

Pobiera lub ustawia wartość określającą, czy w celach debugowania mają być uwzględniane informacje o zarządzanych wyjątkach.Gets or sets a value that specifies whether to include managed exception information in the detail of SOAP faults returned to the client for debugging purposes.

Item[ConfigurationProperty]

Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji.Gets or sets a property or attribute of this configuration element.

(Odziedziczone po ConfigurationElement)
Item[String]

Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji.Gets or sets a property, attribute, or child element of this configuration element.

(Odziedziczone po ConfigurationElement)
LockAllAttributesExcept

Pobiera kolekcję zablokowanych atrybutów.Gets the collection of locked attributes.

(Odziedziczone po ConfigurationElement)
LockAllElementsExcept

Pobiera kolekcję zablokowanych elementów.Gets the collection of locked elements.

(Odziedziczone po ConfigurationElement)
LockAttributes

Pobiera kolekcję zablokowanych atrybutów.Gets the collection of locked attributes.

(Odziedziczone po ConfigurationElement)
LockElements

Pobiera kolekcję zablokowanych elementów.Gets the collection of locked elements.

(Odziedziczone po ConfigurationElement)
LockItem

Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany.Gets or sets a value indicating whether the element is locked.

(Odziedziczone po ConfigurationElement)
Properties

Pobiera kolekcję właściwości.Gets the collection of properties.

(Odziedziczone po ConfigurationElement)

Metody

CopyFrom(ServiceModelExtensionElement)

Kopiuje zawartość określonego elementu konfiguracji do tego elementu konfiguracji.Copies the content of the specified configuration element to this configuration element.

CreateBehavior()

Tworzy rozszerzenie zachowania na podstawie bieżących ustawień konfiguracji.Creates a behavior extension based on the current configuration settings.

(Odziedziczone po BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)

Odczytuje dane XML z pliku konfiguracyjnego.Reads XML from the configuration file.

(Odziedziczone po ConfigurationElement)
Equals(Object)

Porównuje bieżące ConfigurationElement wystąpienie do określonego obiektu.Compares the current ConfigurationElement instance to the specified object.

(Odziedziczone po ConfigurationElement)
GetHashCode()

Pobiera unikatową wartość reprezentującą bieżące ConfigurationElement wystąpienie.Gets a unique value representing the current ConfigurationElement instance.

(Odziedziczone po ConfigurationElement)
GetTransformedAssemblyString(String)

Zwraca przekształconą wersję określonej nazwy zestawu.Returns the transformed version of the specified assembly name.

(Odziedziczone po ConfigurationElement)
GetTransformedTypeString(String)

Zwraca przekształconą wersję określonej nazwy typu.Returns the transformed version of the specified type name.

(Odziedziczone po ConfigurationElement)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
Init()

Ustawia ConfigurationElement obiekt do stanu początkowego.Sets the ConfigurationElement object to its initial state.

(Odziedziczone po ConfigurationElement)
InitializeDefault()

Służy do inicjowania domyślnego zestawu wartości dla ConfigurationElement obiektu.Used to initialize a default set of values for the ConfigurationElement object.

(Odziedziczone po ConfigurationElement)
IsModified()

Pobiera wartość określającą, czy ten element konfiguracji został zmodyfikowany.Gets a value that specifies whether this configuration element has been modified.

(Odziedziczone po ServiceModelExtensionElement)
IsReadOnly()

Pobiera wartość wskazującą, czy ConfigurationElement obiekt jest tylko do odczytu.Gets a value indicating whether the ConfigurationElement object is read-only.

(Odziedziczone po ConfigurationElement)
ListErrors(IList)

Dodaje błędy nieprawidłowej właściwości w tym ConfigurationElement obiekcie i we wszystkich podelementach do listy zakończonych.Adds the invalid-property errors in this ConfigurationElement object, and in all subelements, to the passed list.

(Odziedziczone po ConfigurationElement)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnDeserializeUnrecognizedAttribute(String, String)

Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut.Gets a value indicating whether an unknown attribute is encountered during deserialization.

(Odziedziczone po ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Pobiera wartość wskazującą, czy nieznany element został napotkany podczas deserializacji.Gets a value indicating whether an unknown element is encountered during deserialization.

(Odziedziczone po ConfigurationElement)
OnRequiredPropertyNotFound(String)

Zgłasza wyjątek, gdy wymagana właściwość nie zostanie znaleziona.Throws an exception when a required property is not found.

(Odziedziczone po ConfigurationElement)
PostDeserialize()

Wywoływana po deserializacji.Called after deserialization.

(Odziedziczone po ConfigurationElement)
PreSerialize(XmlWriter)

Wywoływana przed serializacji.Called before serialization.

(Odziedziczone po ConfigurationElement)
Reset(ConfigurationElement)

Resetuje stan wewnętrzny tego obiektu elementu konfiguracji, w tym blokady i kolekcje właściwości.Resets the internal state of this configuration element object, including the locks and the properties collections.

(Odziedziczone po ServiceModelExtensionElement)
ResetModified()

Resetuje wartość IsModified() metody do false po zaimplementowaniu w klasie pochodnej.Resets the value of the IsModified() method to false when implemented in a derived class.

(Odziedziczone po ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

Zapisuje zawartość tego elementu konfiguracji w pliku konfiguracji.Writes the contents of this configuration element to the configuration file.

(Odziedziczone po ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)

Zapisuje zewnętrzne Tagi tego elementu konfiguracji w pliku konfiguracji po zaimplementowaniu w klasie pochodnej.Writes the outer tags of this configuration element to the configuration file when implemented in a derived class.

(Odziedziczone po ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Ustawia właściwość na określoną wartość.Sets a property to the specified value.

(Odziedziczone po ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)

Ustawia wartość właściwości dla elementu konfiguracji, jeśli wartość nie jest wartością domyślną.Sets the property value for the configuration element if the value is not the default value.

(Odziedziczone po ServiceModelConfigurationElement)
SetReadOnly()

Ustawia IsReadOnly() Właściwość dla ConfigurationElement obiektu i wszystkie podelementy.Sets the IsReadOnly() property for the ConfigurationElement object and all subelements.

(Odziedziczone po ConfigurationElement)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Modyfikuje ConfigurationElement obiekt, aby usunąć wszystkie wartości, które nie powinny być zapisane.Modifies the ConfigurationElement object to remove all values that should not be saved.

(Odziedziczone po ConfigurationElement)

Dotyczy

Zobacz też