ServiceDebugElement Sınıf

Tanım

Ad Alanı:

System.ServiceModel.Configuration

Bütünleştirilmiş Kod:

System.ServiceModel.dll

Windows Communication Foundation (WCF) hizmeti için hata ayıklama ve yardım bilgileri özelliklerini belirten bir yapılandırma öğesini temsil eder. Bu sınıf devralınamaz.

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

Devralma

Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement

ServiceDebugElement

Örnekler

Aşağıdaki kod örneğinde, HTML yardım sayfası özelliğini etkinleştirmek için yapılandırma dosyasının nasıl kullanılacağı ve bir SOAP hatasının içindeki özel durum bilgilerinin hata ayıklama amacıyla istemciye nasıl döndürüleceği gösterilmektedir (meta veri desteğini etkinleştirmeye ek olarak).

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

Açıklamalar

özelliğini true program aracılığıyla olarak ayarlarsanızIncludeExceptionDetailInFaults, yönetilen özel durum bilgilerinin istemciye akışını hata ayıklama amacıyla etkinleştirebilir ve web tarayıcılarında hizmete göz atan kullanıcılar için HTML bilgi dosyalarının yayımlanmasını sağlayabilirsiniz.

Dikkat

Yönetilen özel durum bilgilerinin hizmetlere döndürüleceği bir güvenlik riski olabilir. Bunun nedeni, özel durum ayrıntılarının yetkisiz hizmetler tarafından kullanılabilecek iç istemci uygulaması hakkındaki bilgileri ortaya çıkarmış olmasıdır.

HttpHelpPageEnabled ve HttpsHelpPageEnabled özellikleri, hizmet bir HTML tarayıcısı kullanılarak görüntülendiğinde hizmete HTML yardım dosyalarını yayımlamasını emreder.

ve HttpsHelpPageUrl özellikleri, HttpHelpPageUrl görüntülenen HTML yardım sayfasının konumunu denetler.

Yapılandırma dosyası kullanarak özelliklerden ServiceDebugElement birini etkinleştirmek veya devre dışı bırakmak için şunları yapmalısınız:

1. WCF hizmetinizin hizmet> öğesine bir öznitelik< ekleyin.behaviorConfiguration (Uç nokta davranışları öğelerde <endpoint> yapılandırılır; hizmet öğelerindeki <hizmet> davranışları.)

2. serviceBehaviors> bölümüne ekleyin veya bu< bölüme 1. adımdaki öznitelik değeriyle eşleşen behaviorConfiguration adla bir <davranış> öğesi ekleyin. (Uç nokta davranışları endpointBehaviors<> öğesi kullanılarak yapılandırılır; hizmet davranışları bir <serviceBehaviors> öğesi kullanılarak yapılandırılır.

3. 2. adımdaki davranış> öğesine bir serviceDebug öğesi< ekleyin ve senaryonuza uygun çeşitli özellikleri etkinleştirin veya devre dışı bırakın.><

Belirli bir örnek için Örnek bölümüne bakın.

Oluşturucular

Name	Description
ServiceDebugElement()	ServiceDebugElement sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
BehaviorType	Bu davranış öğesinin türünü alır.
ConfigurationElementName	Bu yapılandırma öğesinin adını alır. (Devralındığı yer: ServiceModelExtensionElement)
CurrentConfiguration	Geçerli Configuration örneğin ait olduğu yapılandırma hiyerarşisini temsil eden en üst düzey ConfigurationElement örneğe başvuru alır. (Devralındığı yer: ConfigurationElement)
ElementInformation	Özelleştirilebilir olmayan bilgileri ve nesnenin işlevselliğini ElementInformation içeren bir ConfigurationElement nesne alır. (Devralındığı yer: ConfigurationElement)
ElementProperty	Nesnenin ConfigurationElementProperty kendisini temsil ConfigurationElement eden nesneyi alır. (Devralındığı yer: ConfigurationElement)
EvaluationContext	ContextInformation nesnesi için ConfigurationElement nesnesini alır. (Devralındığı yer: ConfigurationElement)
HasContext	özelliğinin CurrentConfigurationolup olmadığını null gösteren bir değer alır. (Devralındığı yer: ConfigurationElement)
HttpHelpPageBinding	Hizmet yardım sayfasına erişmek için HTTP kullanıldığında kullanılacak bağlamayı belirten bir dize değeri alır veya ayarlar.
HttpHelpPageBindingConfiguration	içinde HttpHelpPageBindingbelirtilen bağlama için ek yapılandırma bilgilerini tanımlayan xml bölümüne işaret eden bir dize alır veya ayarlar.
HttpHelpPageEnabled	Windows Communication Foundation'ın (WCF) özelliği tarafından HttpHelpPageUrl belirtilen adreste bir HTML yardım sayfası yayımlayıp yayımlamadığını belirten bir değer alır veya ayarlar.
HttpHelpPageUrl	HTML yardım dosyasının yayımlandığı konumu alır veya ayarlar.
HttpsHelpPageBinding	Hizmet yardım sayfasına erişmek için HTTPS kullanıldığında kullanılacak bağlamayı belirten bir dize değeri alır veya ayarlar.
HttpsHelpPageBindingConfiguration	içinde HttpsHelpPageBindingbelirtilen bağlama için ek yapılandırma bilgilerini tanımlayan xml bölümüne işaret eden bir dize alır veya ayarlar.
HttpsHelpPageEnabled	Windows Communication Foundation'ın (WCF) özelliği tarafından HttpsHelpPageUrl belirtilen adreste HTTPS üzerinden bir HTML yardım dosyası döndürdüğünü belirten bir değer alır veya ayarlar.
HttpsHelpPageUrl	BIR HTML yardım dosyasının HTTPS kullanılarak alınması için yayımlandığı konumu alır veya ayarlar.
IncludeExceptionDetailInFaults	Hata ayıklama amacıyla istemciye döndürülen SOAP hatalarının ayrıntılarına yönetilen özel durum bilgilerinin eklenip eklenmeyeceğini belirten bir değer alır veya ayarlar.
Item[ConfigurationProperty]	Bu yapılandırma öğesinin özelliğini veya özniteliğini alır veya ayarlar. (Devralındığı yer: ConfigurationElement)
Item[String]	Bu yapılandırma öğesinin bir özelliğini, özniteliğini veya alt öğesini alır veya ayarlar. (Devralındığı yer: ConfigurationElement)
LockAllAttributesExcept	Kilitli özniteliklerin koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockAllElementsExcept	Kilitli öğeler koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockAttributes	Kilitli özniteliklerin koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockElements	Kilitli öğeler koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockItem	Öğesinin kilitli olup olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: ConfigurationElement)
Properties	Özellik koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)

Yöntemler

Name	Description
CopyFrom(ServiceModelExtensionElement)	Belirtilen yapılandırma öğesinin içeriğini bu yapılandırma öğesine kopyalar.
CreateBehavior()	Geçerli yapılandırma ayarlarını temel alan bir davranış uzantısı oluşturur. (Devralındığı yer: BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	Yapılandırma dosyasından XML okur. (Devralındığı yer: ConfigurationElement)
Equals(Object)	Geçerli ConfigurationElement örneği belirtilen nesneyle karşılaştırır. (Devralındığı yer: ConfigurationElement)
GetHashCode()	Geçerli ConfigurationElement örneği temsil eden benzersiz bir değer alır. (Devralındığı yer: ConfigurationElement)
GetTransformedAssemblyString(String)	Belirtilen derleme adının dönüştürülmüş sürümünü döndürür. (Devralındığı yer: ConfigurationElement)
GetTransformedTypeString(String)	Belirtilen tür adının dönüştürülmüş sürümünü döndürür. (Devralındığı yer: ConfigurationElement)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
Init()	ConfigurationElement Nesneyi ilk durumuna ayarlar. (Devralındığı yer: ConfigurationElement)
InitializeDefault()	Nesne için varsayılan değer kümesini başlatmak için ConfigurationElement kullanılır. (Devralındığı yer: ConfigurationElement)
IsModified()	Bu yapılandırma öğesinin değiştirilip değiştirilmediğini belirten bir değer alır. (Devralındığı yer: ServiceModelExtensionElement)
IsReadOnly()	Nesnenin ConfigurationElement salt okunur olup olmadığını gösteren bir değer alır. (Devralındığı yer: ConfigurationElement)
ListErrors(IList)	Bu ConfigurationElement nesnedeki ve tüm alt öğelerdeki invalid-property hatalarını geçirilen listeye ekler. (Devralındığı yer: ConfigurationElement)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnDeserializeUnrecognizedAttribute(String, String)	Seri durumdan çıkarma sırasında bilinmeyen bir öznitelikle karşılaşılıp karşılaşılmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Seri durumdan çıkarma sırasında bilinmeyen bir öğeyle karşılaşılıp karşılaşılmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement)
OnRequiredPropertyNotFound(String)	Gerekli bir özellik bulunamadığında bir özel durum oluşturur. (Devralındığı yer: ConfigurationElement)
PostDeserialize()	Seri durumdan çıkarıldıktan sonra çağrılır. (Devralındığı yer: ConfigurationElement)
PreSerialize(XmlWriter)	Serileştirmeden önce çağrılır. (Devralındığı yer: ConfigurationElement)
Reset(ConfigurationElement)	Kilitler ve özellik koleksiyonları dahil olmak üzere bu yapılandırma öğesi nesnesinin iç durumunu sıfırlar. (Devralındığı yer: ServiceModelExtensionElement)
ResetModified()	Türetilmiş bir sınıfta uygulandığında yönteminin IsModified()false değerini olarak sıfırlar. (Devralındığı yer: ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Bu yapılandırma öğesinin içeriğini yapılandırma dosyasına yazar. (Devralındığı yer: ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Türetilmiş bir sınıfta uygulandığında bu yapılandırma öğesinin dış etiketlerini yapılandırma dosyasına yazar. (Devralındığı yer: ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Bir özelliği belirtilen değere ayarlar. (Devralındığı yer: ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Değer varsayılan değer değilse yapılandırma öğesinin özellik değerini ayarlar. (Devralındığı yer: ServiceModelConfigurationElement)
SetReadOnly()	IsReadOnly() Nesnenin ve tüm alt öğelerinin ConfigurationElement özelliğini ayarlar. (Devralındığı yer: ConfigurationElement)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	ConfigurationElement Kaydedilmemesi gereken tüm değerleri kaldırmak için nesnesini değiştirir. (Devralındığı yer: ConfigurationElement)

Ayrıca bkz.

• <serviceDebug>