SoapException.Detail Eigenschap

public:
 property System::Xml::XmlNode ^ Detail { System::Xml::XmlNode ^ get(); };

public System.Xml.XmlNode Detail { get; }

member this.Detail : System.Xml.XmlNode

Public ReadOnly Property Detail As XmlNode

Waarde van eigenschap

De toepassingsspecifieke foutgegevens.

Voorbeelden

In het volgende voorbeeld wordt een SoapException, waarbij de XML-webservicemethode de Detail eigenschap instelt.

<%@ WebService Language="C#" class="ThrowSoapException"%>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml.Serialization;
using System.Xml;

public class ThrowSoapException : WebService 
{
    // This XML Web service method generates a SOAP client fault code. 
    [WebMethod]
    public void myThrow(){

        // Build the detail element of the SOAP fault.
        System.Xml.XmlDocument doc = new System.Xml.XmlDocument();
        System.Xml.XmlNode node = doc.CreateNode(XmlNodeType.Element, 
            SoapException.DetailElementName.Name, 
            SoapException.DetailElementName.Namespace);


        // Build specific details for the SoapException.
        // Add first child of detail XML element.
        System.Xml.XmlNode details = doc.CreateNode(XmlNodeType.Element, 
            "mySpecialInfo1", "http://tempuri.org/");
        System.Xml.XmlNode detailsChild = doc.CreateNode(XmlNodeType.Element, 
            "childOfSpecialInfo", "http://tempuri.org/");
        details.AppendChild(detailsChild);

            
        // Add second child of detail XML element with an attribute.
        System.Xml.XmlNode details2 = doc.CreateNode(XmlNodeType.Element, 
            "mySpecialInfo2", "http://tempuri.org/");
        XmlAttribute attr = doc.CreateAttribute("t", "attrName", 
            "http://tempuri.org/");
        attr.Value = "attrValue";
        details2.Attributes.Append(attr);

        // Append the two child elements to the detail node.
        node.AppendChild(details);
        node.AppendChild(details2);

            
        //Throw the exception.    
        SoapException se = new SoapException("Fault occurred", 
            SoapException.ClientFaultCode,Context.Request.Url.AbsoluteUri,node);

        throw se;
        return;    
    }
}

<%@ WebService Language="VB" class="ThrowSoapException"%>

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Xml.Serialization
Imports System.Xml

Public Class ThrowSoapException
    Inherits WebService
    
    ' This XML Web service method generates a SOAP client fault code. 
    <WebMethod()> _
    Public Sub myThrow()
        
        ' Build the detail element of the SOAP fault.
        Dim doc As New System.Xml.XmlDocument()
        Dim node As System.Xml.XmlNode = doc.CreateNode(XmlNodeType.Element, _
            SoapException.DetailElementName.Name, _
            SoapException.DetailElementName.Namespace)
 
        ' Build specific details for the SoapException.
        ' Add first child of detail XML element.
        Dim details As System.Xml.XmlNode = doc.CreateNode(XmlNodeType.Element, _
            "mySpecialInfo1", "http://tempuri.org/")

        ' Add second child of detail XML element with an attribute.
        Dim details2 As System.Xml.XmlNode = doc.CreateNode(XmlNodeType.Element, _
            "mySpecialInfo2", "http://tempuri.org/")
        Dim attr As XmlAttribute = doc.CreateAttribute("t", "attrName", _
            "http://tempuri.org/")
        attr.Value = "attrValue"
        details2.Attributes.Append(attr)

        ' Append the two child elements to the detail node.
        node.AppendChild(details)
        node.AppendChild(details2)
                
        ' Throw the exception.    
        Dim se As New SoapException("Fault occurred", SoapException.ClientFaultCode, _
                                    Context.Request.Url.AbsoluteUri, node)
        Throw se
        Return
    End Sub
End Class

Opmerkingen

De Detail eigenschap kan worden ingesteld met behulp van een van de klasseconstructors die een Detail waarde accepteren.

De Detail eigenschap wordt gebruikt om toepassingsspecifieke foutdetails op te geven met betrekking tot het Body element van de SOAP-aanvraag. Als er volgens de SOAP-specificatie een fout optreedt omdat de clientaanvraag niet kan worden verwerkt vanwege het Body element van de SOAP-aanvraag, moet de Detail eigenschap worden ingesteld. Als er een fout optreedt in de headervermeldingen van de SOAP-aanvraag, moet u een SoapHeaderException, zodat de foutdetails worden geretourneerd in de SOAP-header. Als de fout niet optreedt, moet de eigenschap niet worden ingesteld vanwege de verwerking van het BodyDetail element.

Bij het bouwen van een XmlNode voor de Detail eigenschap kunnen de Name en Namespace eigenschappen van DetailElementName deze eigenschap worden gebruikt om consistentie met de SOAP-specificatie te garanderen.

Alle directe onderliggende elementen van het detailelement worden detailvermeldingen genoemd en elke detailvermelding wordt gecodeerd als een onafhankelijk element in het detailelement.

Zie ook

• XmlNode
• SoapHeaderException