ServiceDebugElement Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel.Configuration

Zestaw:

System.ServiceModel.dll

Reprezentuje element konfiguracji, który określa debugowanie i funkcje informacji pomocy dla usługi Windows Communication Foundation (WCF). Klasa ta nie może być dziedziczona.

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

Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement

ServiceDebugElement

Przykłady

Poniższy przykład kodu pokazuje, jak za pomocą pliku konfiguracji włączyć funkcję strony pomocy HTML i zwrócić informacje o wyjątkach wewnątrz błędu PROTOKOŁU SOAP z powrotem do klienta na potrzeby debugowania (oprócz włączania obsługi metadanych).

<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ść ma zostać true ustawiona IncludeExceptionDetailInFaults programowo, możesz włączyć przepływ informacji o wyjątkach zarządzanych do klienta na potrzeby debugowania, a także publikację plików informacyjnych HTML dla użytkowników przeglądających usługę w przeglądarkach sieci Web.

Przestroga

Zwracanie informacji o wyjątkach zarządzanych do usług może stanowić zagrożenie bezpieczeństwa. Jest to spowodowane tym, że szczegóły wyjątku uwidaczniają informacje o wewnętrznej implementacji klienta, które mogą być używane przez nieautoryzowane usługi.

Właściwości HttpHelpPageEnabled i HttpsHelpPageEnabled instruują usługę, aby publikowała pliki pomocy HTML, gdy usługa jest widoczna przy użyciu przeglądarki HTML.

Właściwości HttpHelpPageUrl i HttpsHelpPageUrl kontrolują lokalizację wyświetlanej strony pomocy HTML.

Aby włączyć lub wyłączyć jedną z ServiceDebugElement funkcji przy użyciu pliku konfiguracji, musisz:

1. behaviorConfiguration Dodaj atrybut do <elementu usługi> dla usługi WCF. (Zachowania punktu końcowego są konfigurowane na <endpoint> elementach; zachowania usługi w elementach <usługi> ).

2. Dodaj lub utwórz sekcję <serviceBehaviors> i dodaj <element zachowania> do tej wartości z nazwą zgodną z wartością atrybutu behaviorConfiguration z kroku 1. (Zachowania punktu końcowego< są konfigurowane przy użyciu elementu endpointBehaviors>; zachowania usługi są konfigurowane przy użyciu <elementu serviceBehaviors>.

3. <Dodaj element serviceDebug> do <elementu zachowania> z kroku 2 i włącz lub wyłącz różne właściwości odpowiednie dla danego scenariusza.

Aby zapoznać się z konkretnym przykładem, zobacz sekcję Przykład.

Konstruktory

ServiceDebugElement()

Inicjuje nowe wystąpienie klasy ServiceDebugElement.

Właściwości

BehaviorType	Pobiera typ tego elementu zachowania.
ConfigurationElementName	Pobiera nazwę tego elementu konfiguracji. (Odziedziczone po ServiceModelExtensionElement)
CurrentConfiguration	Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration , które reprezentuje hierarchię konfiguracji, do którego należy bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement)
ElementInformation	ElementInformation Pobiera obiekt, który zawiera niezstosowalne informacje i funkcje ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement)
ElementProperty	ConfigurationElementProperty Pobiera obiekt reprezentujący ConfigurationElement sam obiekt. (Odziedziczone po ConfigurationElement)
EvaluationContext	ContextInformation Pobiera obiekt dla ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement)
HasContext	Pobiera wartość wskazującą, czy CurrentConfiguration właściwość to null. (Odziedziczone po ConfigurationElement)
HttpHelpPageBinding	Pobiera lub ustawia wartość ciągu, która określa powiązanie, które ma być używane, gdy protokół HTTP jest używany do uzyskiwania dostępu do strony pomocy usługi.
HttpHelpPageBindingConfiguration	Pobiera lub ustawia ciąg wskazujący sekcję XML definiującą dodatkowe informacje o konfiguracji powiązania określonego w elemecie HttpHelpPageBinding.
HttpHelpPageEnabled	Pobiera lub ustawia wartość wskazującą, czy program Windows Communication Foundation (WCF) publikuje stronę pomocy HTML pod adresem określonym przez HttpHelpPageUrl właściwość.
HttpHelpPageUrl	Pobiera lub ustawia lokalizację, w której jest publikowany plik pomocy HTML.
HttpsHelpPageBinding	Pobiera lub ustawia wartość ciągu, która określa powiązanie, które ma być używane, gdy protokół HTTPS jest używany do uzyskiwania dostępu do strony pomocy usługi.
HttpsHelpPageBindingConfiguration	Pobiera lub ustawia ciąg wskazujący sekcję XML definiującą dodatkowe informacje o konfiguracji powiązania określonego w elemecie HttpsHelpPageBinding.
HttpsHelpPageEnabled	Pobiera lub ustawia wartość określającą, czy program Windows Communication Foundation (WCF) zwraca plik pomocy HTML za pośrednictwem protokołu HTTPS pod adresem określonym przez HttpsHelpPageUrl właściwość.
HttpsHelpPageUrl	Pobiera lub ustawia lokalizację, w której plik pomocy HTML jest publikowany do pobierania przy użyciu protokołu HTTPS.
IncludeExceptionDetailInFaults	Pobiera lub ustawia wartość określającą, czy należy uwzględnić informacje o wyjątkach zarządzanych w szczegółach błędów protokołu SOAP zwróconych do klienta na potrzeby debugowania.
Item[ConfigurationProperty]	Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Odziedziczone po ConfigurationElement)
Item[String]	Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Odziedziczone po ConfigurationElement)
LockAllAttributesExcept	Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement)
LockAllElementsExcept	Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement)
LockAttributes	Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement)
LockElements	Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement)
LockItem	Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Odziedziczone po ConfigurationElement)
Properties	Pobiera kolekcję właściwości. (Odziedziczone po ConfigurationElement)

Metody

CopyFrom(ServiceModelExtensionElement)	Kopiuje zawartość określonego elementu konfiguracji do tego elementu konfiguracji.
CreateBehavior()	Tworzy rozszerzenie zachowania na podstawie bieżących ustawień konfiguracji. (Odziedziczone po BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationElement)
Equals(Object)	Porównuje bieżące ConfigurationElement wystąpienie z określonym obiektem. (Odziedziczone po ConfigurationElement)
GetHashCode()	Pobiera unikatową wartość reprezentującą bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement)
GetTransformedAssemblyString(String)	Zwraca przekształconą wersję określonej nazwy zestawu. (Odziedziczone po ConfigurationElement)
GetTransformedTypeString(String)	Zwraca przekształconą wersję określonej nazwy typu. (Odziedziczone po ConfigurationElement)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
Init()	ConfigurationElement Ustawia obiekt na stan początkowy. (Odziedziczone po ConfigurationElement)
InitializeDefault()	Służy do inicjowania domyślnego zestawu wartości dla ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement)
IsModified()	Pobiera wartość określającą, czy ten element konfiguracji został zmodyfikowany. (Odziedziczone po ServiceModelExtensionElement)
IsReadOnly()	Pobiera wartość wskazującą, czy ConfigurationElement obiekt jest tylko do odczytu. (Odziedziczone po ConfigurationElement)
ListErrors(IList)	Dodaje błędy nieprawidłowej właściwości w tym ConfigurationElement obiekcie i we wszystkich podelementach do przekazanej listy. (Odziedziczone po ConfigurationElement)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnDeserializeUnrecognizedAttribute(String, String)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Odziedziczone po ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Odziedziczone po ConfigurationElement)
OnRequiredPropertyNotFound(String)	Zgłasza wyjątek, gdy nie znaleziono wymaganej właściwości. (Odziedziczone po ConfigurationElement)
PostDeserialize()	Wywoływana po deserializacji. (Odziedziczone po ConfigurationElement)
PreSerialize(XmlWriter)	Wywoływane przed serializacji. (Odziedziczone po ConfigurationElement)
Reset(ConfigurationElement)	Resetuje wewnętrzny stan tego obiektu elementu konfiguracji, w tym blokady i kolekcje właściwości. (Odziedziczone po ServiceModelExtensionElement)
ResetModified()	Resetuje wartość IsModified() metody w false przypadku implementacji w klasie pochodnej. (Odziedziczone po ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Zapisuje zawartość tego elementu konfiguracji w pliku konfiguracji. (Odziedziczone po ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Ustawia właściwość na określoną wartość. (Odziedziczone po ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Ustawia wartość właściwości elementu konfiguracji, jeśli wartość nie jest wartością domyślną. (Odziedziczone po ServiceModelConfigurationElement)
SetReadOnly()	IsReadOnly() Ustawia właściwość obiektu ConfigurationElement i wszystkich podelementów. (Odziedziczone po ConfigurationElement)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modyfikuje obiekt, ConfigurationElement aby usunąć wszystkie wartości, które nie powinny być zapisywane. (Odziedziczone po ConfigurationElement)

Zobacz też

• <serviceDebug>