<serviceDebug>
A Windows Communication Foundation (WCF) szolgáltatás hibakeresési és súgóinformációs funkcióit határozza meg.
<Konfigurációs>
<system.serviceModel>
<Viselkedésmódok>
<serviceBehaviors>
<Viselkedés>
<serviceDebug>
Syntax
<serviceDebug httpHelpPageBinding="String"
httpHelpPageBindingConfiguration="String"
httpHelpPageEnabled="Boolean"
httpHelpPageUrl="Uri"
httpsHelpPageBinding="String"
httpsHelpPageBindingConfiguration="String"
httpsHelpPageEnabled="Boolean"
httpsHelpPageUrl="Uri"
includeExceptionDetailInFaults="Boolean" />
Attribútumok és elemek
Az alábbi szakaszok az attribútumokat, a gyermekelemeket és a szülőelemeket ismertetik.
Attribútumok
Attribútum | Leírás |
---|---|
httpHelpPageBinding | Egy sztringérték, amely meghatározza, hogy milyen típusú kötést használjon a http a szolgáltatás súgóoldalának eléréséhez. Csak a belső System.ServiceModel.Channels.IReplyChannel kötési elemekkel rendelkező kötések támogatottak. A kötés tulajdonságának továbbá System.ServiceModel.Channels.MessageVersion a következőnek kell lennie MessageVersion.None: . |
httpHelpPageBindingConfiguration | Egy sztring, amely megadja az attribútumban httpHelpPageBinding megadott kötés nevét, amely a kötés további konfigurációs információira hivatkozik. Ugyanazt a nevet kell definiálni a <bindings> szakaszban. |
httpHelpPageEnabled | Logikai érték, amely azt szabályozza, hogy a WCF közzétesz-e HTML-súgólapot az httpHelpPageUrl attribútum által megadott címen. A mező alapértelmezett értéke: true .Ezt a tulajdonságot beállíthatja úgy, hogy false letiltsa a HTML-böngészők számára látható HTML-súgólap közzétételét.Annak biztosításához, hogy a HTML súgóoldala az attribútum által httpHelpPageUrl szabályozott helyen legyen közzétéve, ezt az attribútumot értékre kell állítania true . Emellett az alábbi feltételek egyikének is teljesülnie kell:– Az httpHelpPageUrl attribútum egy abszolút cím, amely támogatja a HTTP protokollsémát.– A szolgáltatásnak van egy alapcíme, amely támogatja a HTTP protokoll sémáját. Bár kivétel történik, ha az attribútumhoz egy olyan abszolút cím van hozzárendelve httpHelpPageUrl , amely nem támogatja a HTTP protokollsémát, minden más olyan forgatókönyv, amelyben az előző feltételek egyike sem teljesül, nem eredményez kivételt, és nem tartalmaz HTML-súgólapot. |
httpHelpPageUrl | Egy URI, amely megadja annak az egyéni HTML-súgófájlnak a relatív vagy abszolút HTTP-alapú URL-címét, amelyet a felhasználó lát, amikor a végpontot HTML-böngészővel tekinti meg. Ezzel az attribútummal engedélyezheti egy EGYÉNI HTML-súgófájl használatát, amelyet egy HTTP/Get kérésből, például egy HTML-böngészőből ad vissza. A HTML-súgófájl helye a következőképpen oldható fel. 1. Ha az attribútum értéke egy relatív cím, a HTML-súgófájl helye a HTTP-kéréseket támogató szolgáltatásbázis-cím értéke, valamint ez a tulajdonságérték. 2. Ha az attribútum értéke abszolút cím, és támogatja a HTTP-kéréseket, a HTML-súgófájl helye ennek a tulajdonságnak az értéke. 3. Ha az attribútum értéke abszolút, de nem támogatja a HTTP-kéréseket, kivétel történik. Ez az attribútum csak akkor érvényes, ha az httpHelpPageEnabled attribútum .true |
httpsHelpPageBinding | Egy sztringérték, amely meghatározza, hogy milyen típusú kötést használjon a HTTPS a szolgáltatás súgóoldalának eléréséhez. Csak a belső IReplyChannel kötési elemekkel rendelkező kötések támogatottak. A kötés tulajdonságának továbbá System.ServiceModel.Channels.MessageVersion a következőnek kell lennie MessageVersion.None: . |
httpsHelpPageBindingConfiguration | Egy sztring, amely megadja az attribútumban httpsHelpPageBinding megadott kötés nevét, amely a kötés további konfigurációs információira hivatkozik. Ugyanazt a nevet kell definiálni a <bindings> szakaszban. |
httpsHelpPageEnabled | Logikai érték, amely azt szabályozza, hogy a WCF közzétesz-e HTML-súgólapot az httpsHelpPageUrl attribútum által megadott címen. A mező alapértelmezett értéke: true .Ezt a tulajdonságot beállíthatja úgy, hogy false letiltsa a HTML-böngészők számára látható HTML-súgólap közzétételét.Annak biztosításához, hogy a HTML súgóoldala az attribútum által httpsHelpPageUrl szabályozott helyen legyen közzétéve, ezt az attribútumot értékre kell állítania true . Emellett az alábbi feltételek egyikének is teljesülnie kell:– Az httpsHelpPageUrl attribútum egy abszolút cím, amely támogatja a HTTPS protokoll sémáját.– A szolgáltatásnak van egy alapcíme, amely támogatja a HTTPS protokoll sémáját. Bár kivételt jelent, ha a HTTPS protokoll sémáját nem támogató abszolút cím van hozzárendelve az httpsHelpPageUrl attribútumhoz, minden más olyan forgatókönyv, amelyben az előző feltételek egyike sem teljesül, nem eredményez kivételt, és nem tartalmaz HTML-súgólapot. |
httpsHelpPageUrl | Egy URI, amely megadja annak az egyéni HTML-súgófájlnak a relatív vagy abszolút HTTPS-alapú URL-címét, amelyet a felhasználó lát, amikor a végpontot HTML-böngészővel tekinti meg. Ezzel az attribútummal engedélyezheti egy EGYÉNI HTML-súgófájl használatát, amelyet egy HTTPS/Get kérésből, például egy HTML-böngészőből ad vissza. A HTML-súgófájl helye a következőképpen oldható fel: – Ha a tulajdonság értéke egy relatív cím, a HTML-súgófájl helye a HTTPS-kéréseket támogató szolgáltatásbázis-cím értéke, valamint ez a tulajdonságérték. – Ha a tulajdonság értéke abszolút cím, és támogatja a HTTPS-kéréseket, a HTML-súgófájl helye ennek a tulajdonságnak az értéke. – Ha a tulajdonság értéke abszolút, de nem támogatja a HTTPS-kéréseket, kivétel történik. Ez az attribútum csak akkor érvényes, ha az httpHelpPageEnabled attribútum .true |
includeExceptionDetailInFaults | Egy érték, amely meghatározza, hogy szerepeljenek-e felügyelt kivételadatok az ügyfélnek hibakeresés céljából visszaadott SOAP-hibák részleteiben. A mező alapértelmezett értéke: false .Ha ezt az attribútumot értékre true állítja, engedélyezheti a felügyelt kivételinformációk áramlását az ügyfél számára hibakeresés céljából, valamint HTML-információs fájlok közzétételét a szolgáltatást böngészőkben böngésző felhasználók számára. Figyelem: A felügyelt kivételadatok ügyfeleknek való visszaadása biztonsági kockázatot jelenthet. Ennek az az oka, hogy a kivétel részletei olyan belső szolgáltatás-implementációval kapcsolatos információkat fednek fel, amelyeket jogosulatlan ügyfelek használhatnak. |
Gyermekelemek
Nincsenek.
Szülőelemek
Elem | Leírás |
---|---|
<Viselkedés> | Egy viselkedési elemet határoz meg. |
Megjegyzések
A beállítás includeExceptionDetailInFaults
lehetővé true
teszi, hogy a szolgáltatás visszaadja az alkalmazáskód által okozott kivételeket, még akkor is, ha a kivétel nincs deklarálva a FaultContractAttributehasználatával. Ez a beállítás akkor hasznos, ha hibakeresést folytat olyan esetekben, amikor a kiszolgáló váratlan kivételt jelez. Ennek az attribútumnak a használatával az ismeretlen kivétel szerializált formáját adja vissza, és további részleteket is megvizsgálhat a kivételről.
Figyelemfelhívás
A felügyelt kivételekkel kapcsolatos információk ügyfeleknek való visszaadása biztonsági kockázatot jelenthet, mivel a kivétel részletei olyan belső szolgáltatás-implementációval kapcsolatos információkat fednek fel, amelyeket jogosulatlan ügyfelek használhatnak. Az érintett biztonsági problémák miatt erősen ajánlott, hogy ezt csak ellenőrzött hibakeresési forgatókönyvekben tegye. Az alkalmazás üzembe helyezésekor a értéket kell megadnia includeExceptionDetailInFaults
false
.
A felügyelt kivételekkel kapcsolatos biztonsági problémák részleteiért lásd: Hibák megadása és kezelése a szerződésekben és szolgáltatásokban. Kódmintáért lásd: Szolgáltatás hibakeresési viselkedése.
A súgóoldalt is beállíthatja httpsHelpPageEnabled
, httpsHelpPageUrl
illetve engedélyezheti vagy letilthatja. Az egyes szolgáltatások opcionálisan közzétehetnek egy súgólapot, amely a szolgáltatással kapcsolatos információkat tartalmazza, beleértve a végpontot is a szolgáltatás WSDL-jének lekéréséhez. Ez a beállítással httpHelpPageEnabled
true
engedélyezhető. Ez lehetővé teszi, hogy a súgóoldal a szolgáltatás alapcímére irányuló GET-kéréshez adhatók vissza. Ezt a címet az attribútum beállításával módosíthatja httpHelpPageUrl
. Emellett a HTTP helyett HTTPS használatával is biztonságossá teheti ezt.
A választható httpHelpPageBinding
és httpHelpPageBinding
attribútumok lehetővé teszik a szolgáltatás weblapjának eléréséhez használt kötések konfigurálását. Ha nincsenek megadva, az alapértelmezett kötések (HttpTransportBindingElement
HTTP és HttpsTransportBindingElement
HTTPS esetén ) a szolgáltatás súgólapjának megfelelő eléréséhez használatosak. Figyelje meg, hogy ezeket az attribútumokat nem használhatja a beépített WCF-kötésekkel. Csak az xref:System.ServiceModel.Channels.IReplyChannelt> támogató belső kötési elemekkel rendelkező kötések támogatottak. A kötés tulajdonságának továbbá System.ServiceModel.Channels.MessageVersion a következőnek kell lennie MessageVersion.None: .