<serviceDebug>

Makale
06/08/2023

Windows Communication Foundation (WCF) hizmetinin hata ayıklama ve yardım bilgileri özelliklerini belirtir.

<Yapılandırma>
  <system.serviceModel>
    <Davranış>
      <serviceBehaviors>
        <Davranış>
          <serviceDebug>

Syntax

<serviceDebug httpHelpPageBinding="String"
              httpHelpPageBindingConfiguration="String"
              httpHelpPageEnabled="Boolean"
              httpHelpPageUrl="Uri"
              httpsHelpPageBinding="String"
              httpsHelpPageBindingConfiguration="String"
              httpsHelpPageEnabled="Boolean"
              httpsHelpPageUrl="Uri"
              includeExceptionDetailInFaults="Boolean" />

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik	Açıklama
httpHelpPageBinding	Hizmet yardım sayfasına erişmek için HTTP kullanıldığında kullanılacak bağlama türünü belirten dize değeri. Yalnızca destekleyen System.ServiceModel.Channels.IReplyChannel iç bağlama öğelerine sahip bağlamalar desteklenir. Ayrıca, bağlama özelliğinin System.ServiceModel.Channels.MessageVersion olması MessageVersion.Nonegerekir.
httpHelpPageBindingConfiguration	Özniteliğinde belirtilen bağlamanın adını belirten ve bu bağlamanın `httpHelpPageBinding` ek yapılandırma bilgilerine başvuran bir dize. Aynı ad bölümünde tanımlanmalıdır `<bindings>` .
httpHelpPageEnabled	WCF'nin özniteliği tarafından `httpHelpPageUrl` belirtilen adreste bir HTML yardım sayfası yayımlayıp yayımlamadığını denetleyen bir Boole değeri. Varsayılan değer: `true`. Html tarayıcılarında görünen bir HTML yardım sayfasının yayınını devre dışı bırakmak için bu özelliği `false` olarak ayarlayabilirsiniz. HTML yardım sayfasının özniteliği tarafından denetlenen konumda yayımlandığından `httpHelpPageUrl` emin olmak için bu özniteliği olarak `true`ayarlamanız gerekir. Ayrıca, aşağıdaki koşullardan biri de karşılanmalıdır: `httpHelpPageUrl`- Özniteliği, HTTP protokol düzenini destekleyen mutlak bir adrestir. - HTTP protokol düzenini destekleyen hizmet için bir temel adres vardır. ÖZNITELIĞIne HTTP protokol düzenini desteklemeyen bir mutlak adres atanırsa `httpHelpPageUrl` özel durum oluştursa da, önceki ölçütlerden hiçbirinin karşılanmadığı başka bir senaryo özel durum ve HTML yardım sayfasıyla sonuçlanmaz.
httpHelpPageUrl	Uç nokta bir HTML tarayıcısı kullanılarak görüntülendiğinde kullanıcının gördüğü özel HTML yardım dosyasının göreli veya mutlak HTTP tabanlı URL'sini belirten bir URI. Bir HTTP/Get isteğinden, örneğin bir HTML tarayıcısından döndürülen özel bir HTML yardım dosyasının kullanımını etkinleştirmek için bu özniteliği kullanabilirsiniz. HTML yardım dosyasının konumu aşağıdaki gibi çözülür. 1. Bu özniteliğin değeri göreli bir adresse, HTML yardım dosyasının konumu HTTP isteklerini destekleyen hizmet temel adresinin değeri ve bu özellik değeridir. 2. Bu özniteliğin değeri mutlak bir adresse ve HTTP isteklerini destekliyorsa, HTML yardım dosyasının konumu bu özelliğin değeridir. 3. Bu özniteliğin değeri mutlaksa ancak HTTP isteklerini desteklemiyorsa, bir özel durum oluşturulur. Bu öznitelik yalnızca özniteliği olduğunda `httpHelpPageEnabledtrue`geçerlidir.
httpsHelpPageBinding	Hizmet yardım sayfasına erişmek için HTTPS kullanıldığında kullanılacak bağlama türünü belirten dize değeri. Yalnızca destekleyen IReplyChannel iç bağlama öğelerine sahip bağlamalar desteklenir. Ayrıca, bağlama özelliğinin System.ServiceModel.Channels.MessageVersion olması MessageVersion.Nonegerekir.
httpsHelpPageBindingConfiguration	Özniteliğinde belirtilen bağlamanın adını belirten ve bu bağlamanın `httpsHelpPageBinding` ek yapılandırma bilgilerine başvuran bir dize. Aynı ad bölümünde tanımlanmalıdır `<bindings>` .
httpsHelpPageEnabled	WCF'nin özniteliği tarafından `httpsHelpPageUrl` belirtilen adreste bir HTML yardım sayfası yayımlayıp yayımlamadığını denetleyen bir Boole değeri. Varsayılan değer: `true`. Html tarayıcılarında görünen bir HTML yardım sayfasının yayınını devre dışı bırakmak için bu özelliği `false` olarak ayarlayabilirsiniz. HTML yardım sayfasının özniteliği tarafından denetlenen konumda yayımlandığından `httpsHelpPageUrl` emin olmak için bu özniteliği olarak `true`ayarlamanız gerekir. Ayrıca, aşağıdaki koşullardan biri de karşılanmalıdır: `httpsHelpPageUrl`- Özniteliği, HTTPS protokol düzenini destekleyen mutlak bir adrestir. - HTTPS protokol düzenini destekleyen hizmet için bir temel adres vardır. ÖZNITELIĞIne HTTPS protokol şemasını desteklemeyen bir mutlak adres atanırsa `httpsHelpPageUrl` özel durum oluştursa da, önceki ölçütlerden hiçbirinin karşılanmadığı diğer senaryolar özel durum ve HTML yardım sayfasıyla sonuçlanmaz.
httpsHelpPageUrl	Uç nokta bir HTML tarayıcısı kullanılarak görüntülendiğinde kullanıcının gördüğü özel HTML yardım dosyasının göreli veya mutlak HTTPS tabanlı URL'sini belirten bir URI. Bir HTTPS/Get isteğinden, örneğin bir HTML tarayıcısından döndürülen özel bir HTML yardım dosyasının kullanımını etkinleştirmek için bu özniteliği kullanabilirsiniz. HTML yardım dosyasının konumu aşağıdaki gibi çözülür: - Bu özelliğin değeri göreli bir adresse, HTML yardım dosyasının konumu HTTPS isteklerini destekleyen hizmet temel adresinin değeri ve bu özellik değeridir. - Bu özelliğin değeri mutlak bir adresse ve HTTPS isteklerini destekliyorsa, HTML yardım dosyasının konumu bu özelliğin değeridir. - Bu özelliğin değeri mutlaksa ancak HTTPS isteklerini desteklemiyorsa, bir özel durum oluşturulur. Bu öznitelik yalnızca özniteliği olduğunda `httpHelpPageEnabledtrue`geçerlidir.
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. Varsayılan değer: `false`. Bu özniteliği olarak `true`ayarlarsanız, 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 bilgilerini istemcilere döndürmek bir güvenlik riski oluşturabilir. Bunun nedeni, özel durum ayrıntılarının yetkisiz istemciler tarafından kullanılabilecek iç hizmet uygulaması hakkındaki bilgileri ortaya çıkarmış olmasıdır.

Alt Öğeler

Yok.

Üst Öğeler

Öğe	Açıklama
<Davranış>	Bir davranış öğesi belirtir.

Açıklamalar

ayarı includeExceptionDetailInFaultstrue , özel durum kullanılarak bildirilmese bile hizmetin uygulama kodu tarafından oluşan özel durumları döndürmesine FaultContractAttributeolanak tanır. Bu ayar, sunucunun beklenmeyen bir özel durum oluşturması durumlarının hatalarını ayıklarken kullanışlıdır. Bu öznitelik kullanılarak, bilinmeyen özel durumun serileştirilmiş bir biçimi döndürülür ve özel durumun daha fazla ayrıntısını inceleyebilirsiniz.

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ülmesinde güvenlik riski olabilir. İlgili güvenlik sorunları nedeniyle, bunu yalnızca denetimli hata ayıklama senaryolarında yapmanız kesinlikle önerilir. Uygulamanızı dağıtırken olarak false ayarlamanız includeExceptionDetailInFaults gerekir.

Yönetilen özel durumla ilgili güvenlik sorunları hakkında ayrıntılı bilgi için bkz. Sözleşmelerde ve Hizmetlerde Hataları Belirtme ve İşleme. Kod örneği için bkz. Hizmet Hata Ayıklama Davranışı.

Ayrıca yardım sayfasını etkinleştirmek veya devre dışı bırakmak için ve httpsHelpPageUrl ayarlayabilirsinizhttpsHelpPageEnabled. Her hizmet isteğe bağlı olarak, hizmet için WSDL'yi almak için uç nokta dahil olmak üzere hizmet hakkında bilgi içeren bir yardım sayfasını kullanıma açabilir. Bu, olarak ayarlanarak httpHelpPageEnabledtrueetkinleştirilebilir. Bu, yardım sayfasının hizmetin temel adresine bir GET isteğine döndürülebilmesini sağlar. Özniteliğini ayarlayarak httpHelpPageUrl bu adresi değiştirebilirsiniz. Ayrıca, HTTP yerine HTTPS kullanarak bunu güvenli hale getirebilirsiniz.

İsteğe bağlı httpHelpPageBinding ve httpHelpPageBinding öznitelikleri, hizmet web sayfasına erişmek için kullanılan bağlamaları yapılandırmanıza olanak sağlar. Belirtilmezse, hizmet yardım sayfası erişimi için varsayılan bağlamalar (HttpTransportBindingElementHTTP ve HttpsTransportBindingElementHTTPS söz konusu olduğunda) uygun şekilde kullanılır. Bu öznitelikleri yerleşik WCF bağlamalarıyla kullanamayacağınıza dikkat edin. Yalnızca xref:System.ServiceModel.Channels.IReplyChannel> destekleyen iç bağlama öğelerine sahip bağlamalar desteklenir. Ayrıca, bağlama özelliğinin System.ServiceModel.Channels.MessageVersion olması MessageVersion.Nonegerekir.

Aracılığıyla paylaş