ServiceDebugBehavior.IncludeExceptionDetailInFaults Özellik

Tanım

Ad Alanı:

System.ServiceModel.Description

Bütünleştirilmiş Kod:

System.ServiceModel.dll

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.

public:
 property bool IncludeExceptionDetailInFaults { bool get(); void set(bool value); };

public bool IncludeExceptionDetailInFaults { get; set; }

member this.IncludeExceptionDetailInFaults : bool with get, set

Public Property IncludeExceptionDetailInFaults As Boolean

Özellik Değeri

Boolean

true Windows Communication Foundation (WCF), istemci hata ayıklama amacıyla SOAP hatalarında yönetilen özel durum bilgileri döndürüyorsa; aksi takdirde , false. Varsayılan değer: false.

Ö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 hata ayıklama amacıyla soap hatasının içindeki özel durum bilgilerinin istemciye nasıl döndürüleceği gösterilmektedir. Bu yapılandırma dosyası, özellikler için destek eklemeye ServiceDebugBehavior yönelik aşağıdaki temel adımları gösterir:

• ServiceDebugBehavior Tür bir System.ServiceModel.Description.IServiceBehavior uygulama olduğundan, <hizmet türünü temsil eden hizmet> öğesinin davranış yapılandırma tanımlayıcısı vardırbehaviorConfiguration="metadataAndDebug".

• Yine, tür bir System.ServiceModel.Description.IServiceBehavior uygulama olduğundan ServiceDebugBehaviorserviceBehaviors> bölümüne bir<davranış> öğesi< eklenir. name değeri, hizmet> öğesinin özniteliğinin tanımlayıcısı olan behavior öğesinin özniteliğini<>ayarlayın.<behaviorConfiguration Bu durumda değeri metadataAndDebug.

• çeşitli öznitelikleri istenen yapılandırmaya ayarlanmış bir <serviceDebug> öğesi ekleyin. Bu durumda ve httpHelpPageEnabledincludeExceptionDetailInFaults öznitelik değerleri olarak trueayarlanır.

<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

Hata ayıklamayı IncludeExceptionDetailInFaults kolaylaştırmak için WCF'ye SOAP hatalarında istemciye yönetilen özel durum bilgileri döndürmesini bildirmek için özelliğini true olarak ayarlayın.

Dikkat

Özel durum ayrıntıları yetkisiz istemciler tarafından kullanılabilecek iç hizmet uygulaması hakkındaki bilgileri kullanıma sunduğundan, yönetilen özel durum bilgilerinin istemcilere döndürülmesi güvenlik riski oluşturabilir. Ayrıca, ServiceDebugBehavior özellikleri program aracılığıyla da ayarlanabilse de, IncludeExceptionDetailInFaults devre dışı bırakmayı dağıtım sırasında unutmak kolay olabilir.

İlgili güvenlik sorunları nedeniyle aşağıdakiler kesinlikle önerilir:

• Özelliğinin IncludeExceptionDetailInFaultstruedeğerini olarak ayarlamak için bir uygulama yapılandırma dosyası kullanırsınız.

• Bunu yalnızca denetimli hata ayıklama senaryolarında yaparsınız.

Daha fazla bilgi için bkz. Sözleşmelerde ve Hizmetlerde Hataları Belirtme ve İşleme.